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本 书 讲解 如 何 用 Node 
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内 容 提 要 


构建 可 扩展 因特网 应 用 ， 是 全 面 的 实用 指南 ， 除 了 详细 介绍 Node 提 



































供 的 API 外 ， 还 用 大 量 篇 幅 介绍 了 服务 器 事件 驱动 开发 的 重要 概念 。 内 容 涉及 跨 服 务 器 的 并 发 








示例 等 。 
本 书 适合 对 JavaScript 
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连接 、 非 阻塞 VO 和 事件 驱动 的 编程 、 如 何 支 持 各 种 数据 库 和 数据 存储 工具 、Node API 的 使 用 












































及 编程 有 一 定 程度 了 解 的 读者 阅读 。 
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“O'Reilly Radar 博客 有 口 绰 碑 。” 





Wired 


“OReilly 凭借 一 系列 ( 真希 望 当 初 我 也 想到 了 ) 非凡 想法 建立 了 数 百 万 美元 的 业务 。” 
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“O’Reilly Conference 是 聚集 关键 思想 领袖 的 绝对 典范 。” 
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“一 本 OReilly 的 书 就 代表 一 个 有 用 、 有 前 途 、 需 要 学 习 的 主题 。 





Irish Times 


“Tim 是 位 特 立 独行 的 商人 ， 他 不 光 放 眼 于 最 长 远 、 最 广 阔 的 视野 并 且 切 实地 按照 
Yogi Berra 的 建议 去 做 了 : “如果 你 在 路 上 过 到 偏 路 口 ， 走 小 路 (岔路 ) ”回顾 过 
去 ，Tim 似乎 每 一 次 都 选择 了 小 路 ， 而 且 有 几 次 部 是 一 闪 即 道 的 机 会 ,尽管 大 路 
也 不 错 。 
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Ryan Dah| 序 


2008 年 ， 我 在 寻找 一 个 新 的 编程 平台 来 做 网 站 。 我 并 不 是 想 要 一 门 新 的 语言 ， 实 际 
上 ， 语 言 自身 的 细节 对 我 来 说 并 不 重要 。 我 真正 关心 的 是 ， 该 语言 能 否 提供 先进 的 
推送 功能 并 集成 到 网 站 中 来 ， 就 像 我 在 Gmail 中 看 到 的 那样 一 一 能 够 从 服务 器 端 把 
数据 主动 推送 给 用 户 ， 而 不 是 采用 不 断 轮 询 拉 取 数据 的 方式 。 现 有 的 平台 都 把 服务 
器 作为 接受 请 求 然后 返回 相应 内 容 的 设备 。 要 把 事件 推送 到 浏览 器 ， 平 台 需 要 能 够 
持续 处 理 大 量 打 开 的 网 络 连接 ， 而 这 其 中 有 许多 连接 其 实 是 空间 的 。 











Google 在 2008 年 年 末 推 出 了 Chrome 浏览 器 和 狐 新 的 JavaScript 引擎 V8。 这 是 
一 个 为 了 更 快 的 Web 体验 而 专门 制作 的 更 快 的 avaScript 引擎 ，V8 i 上 Web 应 用 大 
大 提速 了 。 突 然 之 间 ，Google、Apple、Mozilla 和 微软 之 间 的 JavaScript 军备 竞赛 
就 开始 了 。 再 加 上 Doug Crockford 的 JavaScript: The Good Parts 一 书 的 面世 ， 把 
JavaScript 从 一 门人 人 轻视 的 语言 一 下 变 成 了 重要 的 语言 。 


于 是 ， 我 有 了 个 主意 : JavaScript 结合 非 阻塞 socket ! 因为 JavaScript 并 没有 现成 的 
socket 库 ， 所 以 我 可 以 勇 做 第 一 人 ， 来 推介 这 个 加 新 且 大 有 前 途 的 接口 。 只 要 把 V8 
接 上 我 的 非 阻 塞 C 代码 ， 我 就 能 把 它 完 成 。 我 终止 了 当时 承接 的 工作 ， 开 始 全 力 实 
现 这 个 想法 。 当 我 编写 好 并 发 布 了 最 初 的 版 本 后 ， 立 刻 就 有 用 户 开 始 反 馈 bug， 然 
后 我 开始 不 停 地 处 理 这 些 bug， 就 这 样 ， 不 知 不 觉 过 去 了 3 年 。 











实践 证 明 ，JavaScript 与 非 阻 塞 socket 配合 得 相当 完美 。 开 始 我 并 不 敢 肯定 这 一 点 ， 
但 闭 包 让 所 有 事情 变 得 可 能 。 只 需要 简单 的 儿 行 JavaScript 代码 ， 就 可 以 构建 出 非 
常 复杂 的 非 阻 塞 服务 器 。 我 最 初 还 担心 ， 系 统 会 过 于 小 众 ， 但 很 快 我 就 放心 了 ， 
为 世界 各 地 的 黑客 们 纷纷 开始 为 其 编写 程序 库 。 唯 一 的 事件 循环 队列 和 纯粹 的 非 阻 
塞 接口 让 程序 库 不 必 增 加 昂贵 的 线程 ， 就 能 添加 越 来 越 多 的 复杂 功能 。 


在 Node 中 ， 用 户 会 发 现 系统 在 默认 情况 下 就 能 很 好 地 扩展 。 因 为 其 核心 系统 做 出 














的 选择 是 ， 不 允许 系统 中 的 任何 部 分 做 出 太 坏 的 事情 来 〈 比 如 堵塞 当前 线程 )， 所 以 
整体 性 色 也 不 会 大 闫 。 如 果 以 能 够 处 理 的 流量 作为 计量 ，Node 的 方法 要 比 传统 的 阻 
塞 式 操作 好 上 一 个 数量 级 。 


现在 ，Node 已 经 在 全 球 被 众多 公司 所 使 用 ， 包 括 创 业 公 司 、Voxer、Uber， 以 及 沃 
尔 玛 、 微 软 这 样 的 知名 公司 。 可 以 说 ， 每 天 通过 Node 处 理 的 请 求 数 以 亿 计 。 随 着 
越 来 越 多 的 人 参与 到 本 项 目 中 来 ， 可 用 的 第 三 方 模块 和 扩展 增长 迅猛 ， 而 且 质量 也 
不 断 提升 。 虽 然 我 曾 建议 将 Node 用 于 关键 任务 应 用 ， 但 现在 ， 即 便 是 要 求 最 苛刻 
的 服务 器 系统 ， 我 也 会 热诚 地 推荐 使 用 Node。 


本 书 探讨 了 Node 及 许多 第 三 方 模块 ， 并 给 出 了 指导 练习 ， 叶 在 带 你 深入 浅 出 地 了 
解 Node。 通 过 学 习 本 书 ， 你 不 但 能 够 熟悉 JavaScript 的 基本 操作 ， 还 能 逐渐 开始 构 
建 复杂 、 交 互 式 的 网 站 。 如 果 你 曾 ee Web 框架 ， 你 会 震惊 于 用 
Node 这 么 容易 就 能 编写 一 个 服务 器 














一 一 Ryan Dahl，Node.js 的 创建 者 
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Brendan Eich 序 


1995 年 4 月 ,我 加 入 了 Netscape 公司 ， 负 责 “ 把 Scheme 添加 到 浏览 器 里 ”。 一 两 
个 月 后 ， 这 个 任务 却 演变 成 了 “创造 一 门 看 起 来 像 Java 的 脚本 语言 ”。 更 精 糕 的 是 ， 
当时 正在 商议 把 Java 添加 到 Netscape 里 ， 所 以 Netscape 的 一 部 分 人 对 是 否 需 要 一 
门 “第 二 语言 ”表示 怀疑 。 同时， 另外 一 部 分 人 想 要 的 是 类 似 PHP 的 东西 ， 也 就 是 
为 公司 计划 发 布 的 服务 器 产品 LiveWire 写 的 一 门 HTML 模板 语言 。 


于 是 ， 在 1995 年 5 月 ， 我 用 10 天 时 间 开 发 了 Mocha 原型 (代码 名 称 是 Marc An- 
dreessen 挑选 的 ) 。 当 时 ，Marc、Rick Schell (Netscape 的 工程 副 总 裁 ) 和 Sun 公司 
的 Bill Joy 这 几 位 高 层 管理 者 都 支持 我 继续 做 下 去 ， 以 消除 人 们 对 Java 之 后 “第 二 
语言 ”的 怀疑 。( 极 具 讽 刺 的 是 ，Java 几乎 已 在 浏览 器 世界 里 绝迹 了 ， 而 JavaScript 
则 成 为 Web 客户 端的 主导 。) 


为 了 消除 一 切 疑 虑 ， 我 需要 在 10 天 内 拿 出 一 个 能 演示 的 原型 。 当 时 我 日 以 继 夜 地 工 
作 ， 结 果 引 入 了 一 些 设计 语言 的 错误 (其 中 一 些 重复 了 LISP 演变 过 程 中 的 设计 错 
误 ) ， 但 最 终 还 是 赶 在 期 限 前 完成 了 演示 。 


人 们 很 惊讶 ， 我 竞 然 用 不 到 两 周 的 时 间 就 完成 了 一 门 语言 的 编译 器 和 运行 环境 。 其 
实 自从 大 三 那 年 由 物理 专业 转 到 数学 / 计算 机 科学 专业 起 ， 我 已 经 积累 了 十 多 年 的 
经 验 。 我 一 直 很 喜欢 形式 语言 和 自动 机 理论 ， 并 出 于 兴趣 编写 了 自己 的 语言 解析 器 
和 解析 器 生成 器 。 在 Silicon Graphics 的 时 候 ， 我 编写 的 网 络 监控 工具 包含 了 包头 
匹配 、 协 议 描述 语言 和 编译 器 。 此 外 ， 我 还 是 C 和 Unix 的 忠实 粉丝 。 所 以 ， 弄 出 
Mocha 只 不 过 是 一 件 需 要 持续 工作 与 专 广 的 事情 。 
































1995 年 秋天 ，Netscape 市 场 部 把 Mocha 改名 为 LiveScript， 好 让 它 和 服务 器 产品 
LiveWire 的 名 字 相 匹配 。1995 年 12 月 初 ，Netscape 和 Sun 最 终 签订 一 份 商标 使 用 许可 
协议 ， 由 创始 人 B 记 Joy 代表 Sun 公司 签字 生效 ，LiveScript 正式 改名 为 JavaScript (JS )。 


因为 有 LiveWire 服务 器 的 计划 ， 我 在 头 10 天 里 实现 了 一 个 字 节 码 编译 器 和 解释 器 ， 
同时 还 有 反 编 译 器 和 运行 时 程序 (内 置 我 们 今天 熟悉 的 JS 对 象 和 国 数 : Object、 
Array、Function 等 )。 对 于 一 个 小 巧 的 客户 端 脚本 来 说 ， 字 节 码 有 点 大 材 小 用 了 ， 
因为 LiveWire 产品 里 包含 了 一 种 特性 ， 即 能 够 保存 编译 好 的 字 节 码 以 供 服 务 器 端 应 
用 更 快 地 启动 。 


最 终 ， 与 Netscape 其 他 大 部 分 业务 一 样 ，Netscape 的 服务 器 端 JavaSeript 产品 也 失 
败 了 ， 因 为 微软 把 正 浏览 器 绑 定 在 Windows 里 ， 并 进入 了 Netscape 原本 想 开 拓 的 
浏览 器 之 外 的 服务 器 市 场 。 而 绑 定 在 Windows 里 的 下 是 免费 的 ， 因 此 商业 用 户 不 
再 需要 单独 购买 付费 浏览 器 证 书 了 。 


尽管 LiveWire 失败 了 ， 但 早 在 1995 年 我 们 就 已 经 看 到 端 到 端 JavaScript 编程 的 吸 
引力 。 用 户 也 看 到 了 这 个 趋势 ， 但 这 段 历史 只 有 一 小 部 分 人 知道 。 今 天 ，Node.js 避 
开 了 LiveWire 当年 的 致命 错误 : 把 堵塞 式 输入 /输出 包含 在 内 ， 并 在 服务 器 端 使 用 
多 进程 模型 ， 因 而 可 扩展 性 并 不 是 很 好 。 


2009 年 的 JSConf EU 大 会 上 ，Ryan 展示 了 Node.js。 我 为 能 够 了 解 Node 而 感到 
欣慰 ， 也 很 高 兴 它 能 够 很 好 地 实现 彻底 使 用 JavaScript 的 愿景 ， 特 别 是 它 能 从 底层 
构建 起 整个 非 阻 塞 IO 系统 。Ryan 和 其 他 核心 成 员 在 保持 内 核 精致 方面 做 得 很 好 。 
Isaac 及 所 有 模块 所 有 者 共同 构建 起 的 优秀 模块 系统 分 担 了 内 核 的 压力 ， 所 以 它 不 会 
太 过 腔 有 种。 此 外 ， 围 绕 Node 代码 成 长 起 来 的 社区 也 很 出 色 。 


结果 ， 这 就 诞生 了 一 个 有 趣 高 效 的 系统 ， 它 不 仅 能 够 构建 服务 器 端 ， 而 且 能 够 适应 
日 益 提 高 的 产能 ， 还 可 以 很 方便 地 进行 JavaScript 客户 端 程序 开发 ， 并 能 够 促进 代 
码 重用 和 进化 。 如 果 没 有 Node，JavaScript 将 只 能 绑 定 在 Web 客户 端 上 ， 其 备 受 指 
责 的 文档 对 象 模型 以 及 其 他 一 些 历 史 遗 留 问 题 将 会 日 益 突 出 。Node 帮助 JavaScript 
摆脱 了 客户 端的 限制 。 


本 书 很 好 地 诠释 了 Node 的 精髓 ， 并 讲述 了 如 何 用 它 构 建交 互 式 网 络 应 用 和 网 站 。 
Node 棒 极 了 ， 而 本 书 就 是 关于 Node 的 很 好 的 指南 ， 请 尽情 享受 阅读 的 乐趣 吧 ! 


























Brendan Eich，JavaScript 的 创建 者 
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Node.js 正 迅 速成 为 Web 开发 社区 里 最 有 影响 力 的 技术 。 本 书 的 目标 是 让 开发 人 员 





有 效 地 了 解 如 何 入 手 试 用 Node。 


本 书 读者 应 该 对 JavaScript 及 编程 有 一 定 程度 的 了 解 。 除 了 详细 介绍 Node 提供 的 





API 外 ， 我 们 还 将 花 大 量 篇 幅 来 介绍 服务 器 事件 驱动 开发 的 重要 概念 。 


通过 阅读 本 书 ， 你 不 但 能 够 了 解 Node 平台 本 身 ， 还 能 掌握 Node 为 快速 高 效 地 构建 


高 扩展 性 网 站 和 服务 所 提供 的 多 个 重要 模块 。 


排版 约定 


本 书 使 用 了 下 列 排版 约定 。 
。 楷体 

表示 新 术语 。 
等 宽 字 体 


表示 程序 片段 ， 也 表示 在 正文 中 出 现 的 变量 、 函 数 名 、 数 据 库 、 数 据 类 型 、 
变量 、 语 句 和 关键 字 等 。 


加 粗 等 宽 字体 
表示 用 户 的 输入 。 


环境 





4 这 个 图 标 表 明 提 示 、 建 议 或 一 般 注 记 。 








-Ee 这 个 图 标 表 示警 告 或 警示 。 














使 用 代码 示例 


本 书 用 于 帮助 你 完成 工作 。 通 常 ， 你 可 以 在 程序 或 文档 中 使 用 本 书 提供 的 代码 。 除 
非 你 重新 发 布 我 们 的 大 量 代码 ， 否 则 不 需要 联系 我 们 来 获得 许可 。 比 如 ， 在 程序 中 
使 用 本 书 代 码 的 一 些 片 段 是 无 需 我 们 许可 的 ， 但 是 出 售 或 再 分 发 O'Reilly 的 图 书 示 
例 光盘 显然 是 需要 授权 的 。 引 用 本 书 或 引用 示例 代码 来 回答 问题 是 不 需要 授权 的 ， 
但 是 将 本 书 的 大 量 示 例 代码 整合 到 你 自己 的 产品 文档 必须 得 到 授权 。 


我 们 希望 你 在 使 用 时 声明 引用 信息 ， 但 不 强求 。 引 用 信息 通常 包括 书 名 、 作 者 、 出 
版 社 和 ISBN。 例 如 :“Node: Up and Running by Tom Hughes-Croucher and Mike 
Wilson (O’Reilly). Copyright 2012 Tom Hughes-Croucher and Mike Wilson, 978-1- 
449-39858-3.” 





























如 果 你 认为 对 示例 代码 的 使 用 需要 授权 ， 请 通过 邮箱 permissions@oreilly.com 联系 
我 们 。 


Safari" 在 线 图 书 


S f ee》 ”在线 图 书 是 应 需 而 变 的 数字 图 书馆 。 它 能 够 让 你 非常 轻 





松 地 搜索 7500 多 种 技术 性 和 创新 性 参考 书 以 及 视频 ， 以 
Books Online 便 快 速 地 找到 需要 的 答案 。 











订阅 后 就 可 以 访问 在 线 图 书馆 内 的 所 有 页 面 和 视频 。 可 以 在 手机 或 其 他 移动 设备 上 
阅读 ， 还 能 在 新 书 上 市 之 前 抢先 阅读 ， 也 能 够 看 到 还 在 创作 中 的 书稿 并 向 作者 反馈 
意见 。 复 制 粘贴 代码 示例 、 放 入 收藏 夹 、 下 载 部 分 章节 、 标 记 关键 点 、 做 笔记 甚至 
打印 页 面 等 有 用 的 功能 可 以 节省 大 量 时 间 。 


这 本 书 英 文 版 也 在 其 中 。 欲 访问 本 书 的 英文 版 电子 版 ， 或 者 由 O?Reilly 或 其 他 出 版 
社 出 版 的 相关 图 书 ， 请 到 http://my.safaribooksonline.com 免费 注册 。 
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基础 入 门 


第 1 章 
Node.js 简 介 





Node 功能 强大 ， 特 别 是 它 能 在 浏览 器 以 外 运行 JavaScript。 本 书 将 阐述 这 一 功能 为 
何如 此 重要 ， 以 及 使 用 Node 的 好 处 。 首 先 来 概述 一 下 这 些 特性 。 








很 多 人 将 JavaScript 用 在 前 端 网 站 应 用 开发 上 。Node.js 将 这 一 流行 编程 语言 扩展 到 
了 更 多 的 领域 ， 特 别 是 后 端 网 站 服务 器 开发 。Node 有 几 个 重要 的 特性 值得 我 们 关注 。 


Node 是 对 高 性 能 V8 引擎 的 封装 (V8 是 Google Chrome 浏览 器 的 JavaScript 引擎 ) ， 
通过 提供 一 系列 优化 的 API 类 库 ， 使 V8 在 浏览 器 之 外 依然 能 高 效 运行 。 比 如 ， 在 
服务 器 端 开发 程序 常常 需 要 处 理 二 进 制 文件 ，JavaScript 语言 本 身 对 此 支持 得 不 好 ， 
因此 V8 也 如 此 ， 而 Node 的 Buffer 类 库 提供 了 轻松 操作 二 进 制 数据 的 方法 。 使 用 
Node， 除 了 可 以 直接 操作 V8 的 JavaScript 运行 时 状态 ， 还 能 在 开发 上 得 到 更 多 益处 。 


Node 的 一 大 特性 是 对 高 性 能 的 追求 。 首 先 ，V8 采用 了 编译 领域 的 一 些 最 新 技术 ， 
使 得 用 JavaScript 等 高 级 语言 编写 的 代码 在 运行 效率 上 能 够 接近 用 C 等 底层 语言 纺 
写 的 代码 ， 并 且 开发 成 本 有 所 降低 。 





其 次 ，Node 利用 了 JavaScript 的 事件 驱动 (event-driven) 特性 来 构建 高 度 可 扩展 的 
服务 器 程序 。Node 采用 了 事件 循环 (event loop) 架构 ， 让 开发 高 效 的 服务 器 程序 
变 得 简单 和 安全 。 对 比 其 他 构建 高 性 能 服务 器 的 架构 ，Node 既 保证 了 性 能 ， 又 降低 
了 开发 难度 。 这 是 一 个 极其 重要 的 特性 。 大 家 都 知道 开发 多 线程 并 行程 序 很 困难 ， 
而 且 非 常 容 易 出 错 。Node 却 巧妙 地 回避 了 这 一 难题 ， 并 且 保 持 着 令 人 惊讶 的 高 性 
能 。 当 然 ， 任 何方 法 都 存在 利 次 得 失 ， 在 后 续 章 节 中 ， 将 会 详细 讨论 Node 在 这 其 





























中 是 如 何 取舍 的 。 


Node 提供 了 一 系列 “ 非 阻 塞 ” 国 数 库 来 支持 事件 循环 特性 。 比 如 ， 把 文件 系统 或 数 
据 库 操作 封装 成 事件 驱动 形式 的 函数 接口 。 当 对 文件 系统 发 起 请 求 时 ， 程 序 不 需要 
闲置 等 竺 硬盘 把 文件 读 取 出 来 。 就 像 在 浏览 器 中 onclick 事件 被 触发 后 会 自动 调用 
代码 一 样 ， 非 阻塞 函数 会 在 它 获 得 文件 内 容 后 通知 Node 中 的 程序 。 这 种 方式 让 访 
问 慢 资源 变 得 简单 可 扩展 ， 这 对 JavaScript 程序 员 来 说 可 谓 驾 轻 就 就 ， 甚 至 普通 人 
也 很 容易 掌握 。 


Node 的 强大 特性 还 包括 能 在 服务 器 端 运 行 JavaScript， 尽 管 这 样 的 特性 并 非 Node 
所 独 有 。 如 果 想 在 主流 浏览 器 上 运行 自己 的 应 用 ， 我 们 除了 JavaScript 之 外 没有 什 
么 其 他 选择 。 那 么 要 想 同一 份 代码 在 浏览 器 客户 端 和 服务 器 间 共 享 ， 也 只 能 选择 
JavaScript。 现 在 出 现 了 越 来 越 多 用 JavaScript 编写 的 复杂 网 页 应 用 (如 Gmail)， 如 
果 能 把 越 多 的 代码 共享 到 服务 器 上 运行 ， 那 么 开发 的 成 本 也 会 越 低 。Node 为 服务 器 
端 共 享 网 页 的 JavaScript 代码 铺 平 了 道路 ， 这 是 PHP、Java、Ruby 或 Python 等 其 
他 编程 语言 无 法 提供 的 。 虽 然 也 有 其 他 平台 提供 了 在 服务 器 端 使 用 JavaScript 的 手 
段 ， 但 Node 已 经 先 声 夺 人 ， 迅 速成 为 这 个 领域 的 主流 平台 。 


除了 可 以 用 Node 现 有 的 库 来 构建 应 用 外 ， 开 发 者 也 可 以 轻松 为 其 扩展 新 的 库 ， 这 
实在 令 人 欣喜 。 正 因为 Node 很 容易 扩展 ， 在 Node 项 目 对 外 发 布 后 ， 其 社区 便 迅速 
涌现 出 大 量 扩展 库 。 其 中 许多 是 连接 数据 库 或 其 他 软件 的 驱动 接口 ， 还 有 相当 一 部 
分 是 独立 有 用 的 软件 。 


Node 社区 也 是 非常 值得 称赞 的 。 虽 然 其 社区 非常 年 轻 ， 但 已 经 罕见 地 受到 许多 开发 
者 的 热情 关注 。 初 学 者 和 专家 们 都 聚集 在 此 项 目 上 ， 使 用 它 并 反馈 贡献 到 社区 中 ， 
致力 于 把 Node 社区 建设 成 每 个 人 都 能 够 在 其 中 快乐 地 探索 、 分 享 知识 并 获得 支持 
的 地 方 。 





















































1.1 安装 Node.js 


安装 Node.js 是 极其 简单 的 事情 。Node 能 够 运行 在 Windows、Linux、Mac， 以 及 
Solaris 和 BSD 等 其 他 POSIX 系统 上 。Node.js 能 够 在 以 下 两 个 地 址 获得 : 项 目 官方 
主页 (http://nodejs.org) 和 GitHub 代码 库 (http://github.com/joyent/node)。 你 可 以 
优先 选择 Node 主页 上 提供 的 稳定 发 布 版 。 包 含 最 新 特性 的 版 本 托管 在 GitHub 上 ， 
供 核心 开发 团队 使 用 。 任 何人 想 获 得 一 份 拷贝 也 能 从 GitHub 上 下 载 。 虽 然 这 些 新 
特性 通常 很 炫 ， 但 它们 没有 稳定 版 本 那么 可 靠 。 


让 我 们 从 安装 Node.js 开始 。 首 先 要 从 Node 主页 下 载 最 新 发 布 的 版 本 。 在 Node 主 
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页 上 ， 找 到 下 载 的 链接 。 本 书 印刷 时 的 稳定 发 布 版 本 是 0.6.13'。Node 主页 提供 了 
Windows 和 Mac 的 安装 程序 ， 以 及 源 代 码 包 。 如 果 你 在 使 用 Linux， 可 以 选择 从 源 
代码 安装 ， 也 可 以 使 用 常见 的 包 管 理 程序 (apt-get、yum 等 ) 。 








Node.js 版 本 号 依照 C 的 习惯 : 主 版 本 .次 版 本 . 补丁。 稳定 版 本 的 次 版 本 

心 号 是 偶数 ， 开 发 版 本 的 次 版 本 号 是 奇数 。 虽 然 不 知道 Node 什么 时 候 会 到 

过 1.0 版 本 ,但 可 以 认定 是 在 Windows 和 Unix 版 本 合并 成 一 个 版 本 同时 
发 布 时 。 


如 果 你 使 用 安装 包 ， 可 以 直接 跳 到 1.2 节 。 若 你 采用 源 代 码 安装 ， 需 要 首先 进行 
压 。 使 用 tar 命令 ， 带 上 xzf 参数 。x 参数 表示 解压 (而 不 是 压缩 )，z 参数 告诉 
tar 用 GZIP 算法 进行 解压 ，f 表示 根据 最 后 一 个 参数 的 文件 名 来 解压 〈 见 例 1-1)。 


例 1-1 代码 解压 


enki:Downloads $ tar xzf node-v0.6.6.tar.gz 
enki:Downloads $ cd node-v0.6.6 
enki:node-v0.6.6 $ 1s 




















AUTHORS Makefile common.gypi doc test 
BSDmakefile Makefile-gyp configure lib tools 
ChangeLog README .md configure-gyp node.gyp vcbuild.bat 
LICENSE benchmark deps src wscript 





enki:node-v0.6.6 $ 


下 一 步 是 根据 你 的 系统 进行 配置 。Node.js 安装 采用 configure/make 方法 。 
configure 程序 将 扫描 你 的 系统 ， 查 找 Node 依赖 库 的 路 径 。Node 通常 需要 很 少 的 
依赖 库 。 安 装 需要 Python 2.4 或 更 高 版 本 ， 如 果 你 想 使 用 传输 层 安 全 (TLS) 或 加 
密 (如 SHA1), Node 将 需要 OpenSSL 开发 库 。 运 行 configure 程序 将 提示 你 缺少 
哪些 依赖 库 (参见 例 1-2)。 


例 1-2 Node 安装 的 配置 


enki:node-v0.6.6 $ ./configure 











Checking for program g++ Or C++ : /usr/bin/g++ 
Checking for program cpp : /usr/bin/cpp 
Checking for program ar : /usr/bin/ar 
Checking for program ranlib : /usr/bin/ranlib 
Checking for g++ : OkK 
Checking for program gcc or cc : /usr/bin/gcc 
Checking for gcc : OK 
Checking for library dl : yes 
Checking for openssl : not found 
Checking for function SSL library init : yes 
Checking for header openssl/crypto.h : yes 
Checking for library util : yes 

注 1: 翻译 本 书 时 ， 版 本 已 经 是 0.8.1 了 。 一 一 译 者 注 
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Checking for library rt : not found 
Checking for fdatasync(2) with C++ ;TO 
'configure' finished successfully (0.991s) 
enki:node-v0.6.6 $ 


接着 是 运行 make 来 编译 项 目 ( 例 1-3)。 这 将 在 我 们 一 直 使 用 的 源 代码 文件 夹 下 编 
译 出 可 执行 的 二 进 制 文件 。Node 会 在 编译 过 程 中 列 出 当前 进行 到 第 几 步 ， 以 便 
查看 。 


例 1-3 运行 make 来 编译 


enki:node-v0.6.6 $ make 

Waf: Entering directory '/Users/shimmer/Downloads/node-v0.6.6/0out'! 

DEST OS: darwin 

DEST CPU: x64 

Parallel Jobs: 1 

Product type: program 

[ 1/35] copy: src/node config.h.in -> out/Release/src/node config.h 

[ 2/35] cc: deps/http parser/http parser.c -> out/Release/deps/http_ 
parser/http parser 3.0 

/usr/bin/gcc -rdynamic -pthread -arch x86 64 -9 -03 -DHAVE OPENSSL=1 -D_ 
LARGEFILE SOURCE 

[ 3/35] src/node natives.h: src/node.js lib/dgram.js lib/console.js lib/ 
buffer.js 

[ 4/35] uv: deps/uv/include/uv.h -> out/Release/deps/uv/uv.a 








f: Leaving directory '/Users/shimmer/Downloads/node-v0.6.6/out' 
'build' finished successfully (2m53.573s) 

-rwxr-xr-x 1 shimmer staff 6.8M Jan 3 21:56 out/Release/node 
enki:node-v0.6.6 $ 


最 后 一 步 是 用 make install 来 安装 。 首 先 ， 例 1-4 演示 了 如 何 为 系统 下 全 部 用 户 
安装 Node 程序 。 这 需要 你 有 root 账户 或 者 有 运行 sudo 的 权限 。 


例 1-4 为 系统 下 全 部 用 户 安装 Node 


enki:node-v0.6.6 $ sudo make install 

Password: 

Waf: Entering directory '/Users/shimmer/Downloads/node-v0.6.6/0out'! 

DEST OS: darwin 

DEST CPU: X64 

Parallel Jobs: 1 

Product type: program 

* installing deps/uv/include/ares.h as /usr/local/include/node/ares.h 

* installing deps/uv/include/ares version.h as /usr/local/include/node/ 
ares version.h 

* installing deps/uv/include/uv.h as /usr/local/include/node/uv.h 








* installing out/Release/src/node config.h as /usr/local/include/node/ 





node config.hn 

Waf: Leaving directory '/Users/shimmer/Downloads/node-v0.6.6/out' 
'install' finished successfully (0.915s) 

enki:node-v0.6.6 $ 


如 果 你 想 只 安装 到 本 地 用 户 ， 或 是 不 使 用 sudao 命令 ， 需 要 在 运行 configure 的 时 
候 加 上 --prefix 参数 ， 指 定 路 径 来 代替 默认 安装 〈 例 1-5)。 


例 1-5 安装 到 本 地 用 户 


enki:node-v0.6.6 $ mkdir ~/local 

enki:node-v0.6.6 $ ./configure --prefix=~/local 
Checking for program g++ Or C++ : /usr/bin/g++ 
Checking for program cpp : /usr/bin/cpp 


'configure' finished successfully (0.501s) 

enki:node-v0.6.6 $ make && make install 

Waf: Entering directory '/Users/shimmer/Downloads/node-v0.6.6/0out' 
DEST OS: darwin 

DEST CPU: X64 





* installing out/Release/node as /Users/shimmer/local/bin/node 

* installing out/Release/src/node config.h as /Users/shimmer/local/ 
include/node/... 

Waf: Leaving directory '/Users/shimmer/Downloads/node-v0.6.6/out' 
'install' finished successfully (0.747s) 

enki:node-v0.6.6 $ 


1.2 开始 瑟 代 码 


本 市 将 介绍 一 些 Node 开发 的 基础 内 容 ， 为 进一步 学 习 做 准备 。 


1.2.1 Node REPL 


Node 是 服务 器 程序 ， 人 们 常常 难以 理解 它 也 有 和 Perl、Python、Ruby 一 样 的 运行 
时 环境 。 所 以 通常 我 们 称 Node.js 为 “服务 器 端的 JavaScript”， 但 这 不 能 完全 描述 
Node.js 本 身 。 了 解 Node.js 的 最 佳 方法 是 使 用 其 提供 的 REPL 模式 (Read-Evaluate- 
Print-Loop ， 输 入 - 求 值 - 输出 - 循环 ) ， 即 交互 式 命令 行 解析 器 ， 它 非常 适合 检验 
和 学 习 Node.js。 你 可 以 在 Node 命令 行 解析 器 中 试验 本 书 提供 的 代码 片段 。 此 外 ， 
因为 Node 是 对 V8 的 封装 ， 所 以 Node 命令 行 解析 器 也 是 用 来 轻松 测试 JavaScript 
的 理想 方法 。 同 时 ， 当 你 想 运行 一 个 Node 程序 时 ， 可 以 用 任何 你 喜爱 的 文本 编辑 
器 写 好 并 保存 成 文件 ， 然 后 运行 node filename. jso 命令 行 解析 器 是 极 佳 的 学 习 
和 探索 工具 ， 但 我 们 不 会 将 其 用 在 产品 程序 中 。 
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让 我 们 启动 Node 命令 行 解析 器 ， 来 个 热身 ， 试 验 一 下 JavaScript 吧 (参见 例 1-6) 。 
在 你 的 系统 中 打开 命令 行 终端 。 我 正 使 用 Mac 系统 的 自 定 义 命令 行 环境 ， 所 以 你 的 
系统 提示 可 能 会 有 所 不 同 ， 但 使 用 的 命令 应 该 是 一 样 的 。 


例 1-6 启动 Node 命令 行 解析 器 并 尝试 测试 JavaScript 


SEnki:~ $ node 
上 3525.1 

















es 第 一 行 代码 返回 的 结果 为 false。 这 个 例子 来 自 一 个 收集 JavaScript 诡异 
心 和 奇特 特性 的 网 站 http://wtfjs.com。 
DS 





拥有 一 个 实时 的 开发 环境 ， 你 就 有 了 非常 好 的 学 习 工 具 ， 但 你 还 需要 了 解 Node 解 
析 器 的 一 些 有 用 的 功能 ， 才 能 更 好 地 使 用 它 。 它 提供 了 以 点 号 (.) 开头 的 元 命令 。 
如 .help 会 显示 帮助 菜单 ，.clear 会 清除 当前 运行 的 内 容 ，.exit 将 退出 Node 
解析 器 ( 见 例 1-7)。 其 中 最 有 用 的 命令 是 .clear， 它 会 清除 内 存 中 任何 变量 或 闭 
包 ， 而 不 需要 重启 解析 器 。 


例 1-7 使 用 Node 解析 器 中 的 元 命令 


> console.log('Hello World'); 

Hello World 

> .help 

.Clear Break, and also clear the local context. 
.exit Exit the prompt 

.help Show repl options 

> .clear 

Clearing context... 

> .exit 

Enki:~ $ 


使 用 解析 器 时 ， 输 入 变量 的 名 称 就 会 在 终端 上 显示 其 内 容 。Node 会 尝试 智能 地 显示 
复杂 对 象 ， 比 如 通过 描述 来 反映 对 象 的 内 部 构造 ， 而 不 是 简单 地 将 其 当做 普通 对 象 
来 显示 ( 见 例 1-8)。 主 要 的 例外 是 显示 函数 ， 并 非 解 析 器 无 法 显示 函数 内 容 ， 而 是 
因为 函数 通常 都 很 长 ， 如 果 解 析 器 把 函数 都 展开 ， 很 可 能 会 导致 刷 屏 。 


例 1-8 解析 器 设置 并 显示 对 象 


Enki:~ $ node 
> myobj = {}; 








> myObj .list a [anw， wpDw， rer]; 
[ ra', rp ， ic! ] 
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> myob]j .dqoThat = function(first, second, third) { console.log(first); }; 
[FuNnction] 

> myObj 

{ TistEn [Tar Bi er 

,， doThat: [Function] 


} 


-” 


1.2.2 ”编写 首 个 服务 器 程序 

命令 行 解析 器 是 我 们 学 习 和 试验 的 好 工具 ， 而 Node.js 最 主要 的 应 用 是 服务 器 程 
序 。 设 计 Node.js 的 一 个 主要 目的 是 提供 高 度 可 扩展 的 服务 器 环境 。 这 是 我 们 在 
本 章 开 篇 介绍 过 的 Node 和 V8 引擎 有 所 区 别 的 地 方 。Node 除了 用 V8 引擎 来 解析 
JavaScript 外 ， 还 提供 了 高 度 优化 的 应 用 库 ， 用 来 提高 服务 器 效率 。 比 如 说 ，HTTP 
模块 是 专 为 快速 非 阻塞 式 HTTP 服务 器 而 用 C 重新 编写 的 。 让 我 们 看 一 下 Node 采 
用 HTTP 服务 器 的 “Hello World” 经 典 例 子 ( 例 1-9)。 


例 1-9 “Hello World”Node.js Web 服务 器 


Var http = require('http'); 

http.createServer (function (reqg, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 

}) iSEeN(8124, “127:0.001"); 

console.log('Server running at http://127.0.0.1:8124/'); 


这 个 示例 代码 首先 通过 require 方法 把 HTTP 库 包 含 到 程序 中 来 。 有 许多 语言 都 有 
包含 其 他 库 这 一 方法 ，Node 用 的 是 CommonJS 模块 风格 。Node 模块 将 在 第 8 章 详 
细 人 介绍， 当前 需要 了 解 的 是 ，HTTP 库 所 具有 的 功能 已 经 赋 给 了 http 对 象 。 


下 一 步 ， 我 们 需要 一 个 HTTP 服务 器 。PHP 等 其 他 语言 需要 在 类 似 Apache 这 样 的 
服务 器 中 运行 ， 而 Node 和 它们 不 同 ， 因 为 Node 本 身 就 是 Web 服务 器 。 但 这 同样 
意味 着 我 们 需要 先 创建 该 服务 器 。 下 一 行 代码 调用 HTTP 模块 的 一 个 工厂 模式 方法 
(createServer) 来 创建 新 的 HTTP 服务 器 。 新 创建 的 HTTP 服务 器 并 没有 赋值 给 
任何 变量 ， 它 只 会 成 为 存活 在 全 局 范围 内 的 匿名 对 象 。 我 们 可 以 通过 链 式 调用 来 初 
始 化 服务 器 ， 并 告诉 它 监听 在 8124 端口 。 


当 调用 createserver 的 时 候 ， 我 们 传 了 一 个 匿名 函数 作为 参数 。 此 函数 绑 定 在 
新 创建 服务 器 的 事件 监听 器 上 进行 request 事件 处 理 。 消 息 事 件 是 JavaScript 和 
Node 的 核心 。 在 这 个 例子 中 ， 每 当 一 个 新 的 访问 请 求 到 达 Web 服务 器 ， 它 都 将 调 
用 我 们 指定 的 函数 方法 来 处 理 。 我 们 称 这 类 方法 为 回调 (callback)。 因 为 每 当 一 个 
事件 发 生 时 ， 我 们 将 回调 监听 此 事件 的 所 有 函数 。 
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一 个 很 恰当 的 类 比 是 ， 你 从 书店 预订 一 本 书 ， 等 书 到 货 时 ， 书 店 会 “回调 ”通知 你 
去 取 。 


例子 中 的 回调 函数 有 两 个 参数 ， 一 个 是 请 求 的 对 象 (regq) ， 一 个 是 响应 的 对 象 
(res)。 在 回调 函数 中 ， 我 们 调用 了 res 对 象 的 几 个 方法 ， 这 将 修改 响应 结果 。 例 
1-9 没有 使 用 *eg 对 象 ， 但 你 通常 会 需要 同时 使 用 请 求 和 响应 对 象 。 


首先 我 们 必须 调用 res .writeHead 方法 来 设置 HTTP 响应 头 ， 否 则 就 不 能 返回 
实 内 容 给 客户 端 。 我 们 设置 状态 代码 为 200 (表示 HTTP 状态 代码 “200 OK”)， 
且 传 入 一 段 HTTP 头 描述 。 在 本 例 中 ， 我 们 上 只 指定 了 content -type。 


在 完成 了 HTTP 头 后 ， 我 们 可 以 写 入 HTTP 正文 。 在 本 例 中 ， 我 们 用 一 个 方法 来 同 
时 完成 写 入 正文 及 关闭 连接 。 end 方法 将 会 关闭 HTTP 连接 。 但 因为 我 们 同时 还 传 
入 了 一 个 字符 串 ，enda 方法 将 在 把 此 内 容 发 送 给 客户 端 后 才 关 闭 连 接 。 











ee 了 console.1log 方 法 。 就 像 Firebug 和 Web Inspector 支持 的 
I 览 器 对 应 方法 那样 ， 它 将 在 标准 输出 stdaout 上 打印 信息 


让 我 们 在 Node.js 终端 上 运行 此 程序 ， 并 看 看 运行 结果 ( 例 1-10)。 


例 1-10 运行 “Hello World” 程 序 


Enki:~ $ node 

> Var http = require('http'); 

> http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n') 

}) .listen(8124, "127.0.0.1"); 

> console.log('Server running at http://127.0.0.1:8124/') 

Server running at http://127.0.0.1:8124/ 

node> 


1 里 我 们 运行 Node 解析 器 + 区 甩 策 信 例 于 中 同人 代码 (我 们 不 介意 你 从 网 站 上 

行 复制 粘贴 ) 。Node 解析 器 接受 了 代码 ， 并 用 “…” 提 示 你 的 输入 未 完成 并 等 
， 当 我 们 运行 到 console.1og 那 行 时 ，Node 解析 器 打印 出 server 
running at http://127.0.0.1:8124/。 现 在 我 们 可 以 在 浏览 器 中 访问 “Hello 
World” 例 子 了 (如 图 1-1 所 示 )。 











nal =- 图 localhost:8124 


Hello World 

















-1: 在 浏览 器 中 访问 “Hello World” 
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跑 起 来 了 ! 虽然 这 不 是 一 个 惊人 的 演示 ， 但 我 们 只 用 了 6 行 代码 就 把 “Hello 
World” 程 序 运行 起 来 了 。 我 们 并 不 推荐 这 样 的 代码 风格 ,但 我 们 已 经 往 前 迈 出 第 
一 步 了 。 在 下 一 章 中 ， 我 们 将 看 到 更 多 的 代码 ， 但 接 下 来 我 们 先 思考 一 下 为 什么 
Node 会 发 展 成 为 现在 这 个 样子 。 


1.3 为 什么 选择 Node 


在 写本 书 的 时 候 ， 我 们 清楚 地 知道 Node.js 是 多 么 地 新 。 许 多 平台 要 经 历 多 年 才 被 
人 们 接受 ， 而 在 Nodejs 这 一 革新 的 平台 上 ， 人 们 却 展 现 了 前 所 未 有 的 热情 。 我 们 
希望 通过 探究 人 们 热 圳 于 Node.js 的 原因 ， 帮 助 你 找到 能 产生 共鸣 的 特性 。 通 过 了 
解 Node.js 的 强项 ， 我 们 能 发 掘 出 它 最 擅长 的 领域 。 本 节 将 讨论 是 哪些 因素 造就 了 
Node.js， 它 为 何 能 快速 流行 。 























1.3.1 高 性 能 Web 服 务 器 

当 我 们 在 10 多 年 前 第 一 次 开始 编写 Web 应 用 的 时 候 ，Web 还 非常 小 。 当 然 ， 期 间 
我 们 经 历 了 .com 泡沫 。 但 那 时 从 事 互 联网 行业 的 人 数 还 是 相当 少 ， 创 建 的 网 站 也 没 
现在 这 么 火热 。 时 至 今日 ， 有 了 先进 的 Web 2.0 和 随时 随地 可 以 上 网 的 手机 ， 这 对 
我 们 这 些 开 发 人 员 提 出 了 更 多 的 要 求 。 我 们 不 但 要 提供 更 复杂 、 更 多 交互 、 更 接近 
生活 的 功能 ， 而 且 有 越 来 越 多 的 用 户 通过 各 种 设备 频繁 使 用 这 些 功 能 ， 这 是 一 个 极 
大 的 挑战 。 硬 件 在 持续 改进 ， 同 时 我 们 也 需要 提高 软件 开发 水 平 来 支持 这 些 需求 。 
如 果 只 是 单纯 地 采购 更 多 的 硬件 来 支撑 新 功能 和 新 用 户 ， 就 不 那么 划算 了 。 


Node 给 Web 服务 器 程序 开发 领域 引进 了 事件 驱动 编程 ， 来 尝试 解决 这 一 问题 。 实 
践 证 明 ， 虽 然 Node 不 是 第 一 个 尝试 此 方法 的 平台 ,但 它 是 目前 为 止 最 为 成 功 的 平 
台 ， 而 且 我 们 认为 它 使 用 起 来 也 是 最 容易 的 。 后 续 章 市 会 详细 分 析 事 件 驱动 编程 ， 
在 这 里 我 们 先 对 其 进行 简短 的 介绍 。 想 象 一 下 ， 你 现在 需要 连接 到 一 台 Web 服务 器 
上 获取 一 个 网 页 ， 这 在 正常 的 DSL 连接 速度 下 通常 需要 花费 100 毫秒 左右 。 如 果 连 
接 的 是 一 台 普 通 的 Web 服务 器 ， 它 会 在 服务 器 上 为 你 的 请 求 创建 一 个 新 的 程序 运行 
实例 。 该 程序 自 顶 向 下 运行 ( 按 顺 序 运 行 所 有 的 函数 ) 来 响应 请 求 并 生成 网 页 返回 
给 你 。 这 意味 着 该 服务 器 在 请 求 被 满足 前 需要 一 直 占 用 固定 大 小 的 内 存 ， 其 中 包括 
了 把 数据 返回 给 你 所 要 等 待 的 100 多 毫秒 。Node 则 不 是 采用 此 方式 ， 而 是 在 同一 个 
程序 内 服务 所 有 的 用 户 。 每 当 Node 需要 等 待 一 些 费 时 的 操作 ， 比 如 等 待 确认 你 已 
经 收 到 返回 的 数据 时 (好 让 它 标记 此 请 求 已 经 完成 )， 它 就 继续 处 理 下 一 个 用 户 的 请 
求 去 了 。 我 们 对 细节 描述 得 还 是 太 多 了 ， 但 这 些 特 性 意味 着 Node 在 内 存 处 理 上 比 
传统 服务 器 程序 高 效 得 多 ， 也 就 是 能 够 同时 快速 地 服务 更 多 的 用 户 。 这 是 个 巨大 的 
成 就 ， 人 们 也 为 此 而 热爱 Node。 
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1.3.2 ”专业 的 JavaScript 


人 们 喜欢 Node 的 另 一 个 原因 是 JavaScript。Brendan Eich 在 1995 年 发 明了 
JavaScript 语言 ， 这 是 一 门 在 Netscape 浏览 器 上 使 用 的 简单 脚本 语言 。 令 人 惊讶 的 
是 ， 自 从 JavaScript 出 现 以 来 ， 它 已 经 不 止 运用 在 浏览 器 上 了 。 早 先 Netscape 服 
务 器 程序 就 支持 JavaScript 作为 一 门 服务 器 端 脚本 语言 ( 称 为 LiveScript) 。 虽 然 
JavaScript 当时 并 没有 在 服务 器 端 得 到 广泛 应 用 ， 却 毫 不 妨碍 它 在 快速 发 展 的 浏览 
器 市 场 上 大 受 欢 迎 。JavaScript 和 微软 的 VBScript 展开 了 激烈 竞争 ， 都 想 成 为 Web 
上 的 主流 开发 语言 。 很 难说 明 为 什么 JavaScript 最 终 胜出 ， 也 许 是 因为 微软 允许 
JavaScript 运行 在 IE 浏览 器 上 “， 也 许 是 因为 JavaScript 语言 本 身 优势 明显 ， 无 法 不 
脱颖而出 ， 总 之 它 完胜 了 。 于 是 ， 在 2000 年 初期 ，JavaScript 已 经 成 为 Web 开发 语 
言 的 代名词 ， 不 只 是 在 浏览 器 开发 HTML 的 第 一 选择 ， 而 且 是 唯一 的 选择 。 





这 和 Node.js 又 有 什么 关系 呢 ? 首先 我 们 要 记得 当 AJAX 革命 发 生 ， 并 且 Web 风 
头 正 劲 的 时 候 〈( 想 想 Yahoo!、Amazon、Google 等 是 多 么 风光 )，AJAX 中 “J” 的 
唯一 选择 就 是 JavaScript， 完 全 没有 其 他 替代 品 。 这 导致 整个 行业 急需 大 量 优秀 的 
JavaScript 程序 员 。Web 成 为 一 个 真正 意义 上 的 平台 ， 并 且 附 带 着 JavaScript 是 其 开 
发 语言 ， 这 就 要 求 我 们 这 些 JavaScript 程序 员 去 提升 自身 能 力 。JavaScript 被 视 为 程 
序 员 的 第 二 或 第 三 门 编程 语言 ， 这 本 身 就 反映 出 人 们 对 甚 重要 性 的 重新 认识 。 此 时 
涌现 出 许多 专家 ， 他 们 的 努力 使 JavaScript 越 来 越 为 人 们 所 接受 。 











这 一 运动 的 带头 人 物 当 属 Douglas Crockford。 他 关于 JavaScript 的 文章 和 视频 很 受 
欢迎 ， 帮 助 许 多 程序 员 发 现 了 这 门 备 受 指责 的 语言 中 所 隐藏 的 内 在 美 。 许 多 使 用 
JavaScript 的 程序 员 为 了 处 理 HTML 和 XML 文档 ， 把 主要 精力 花费 在 了 浏览 器 对 
W3C DOM API 的 不 同 实现 上 。 可 翡 的 是 ，DOM 可 能 是 API 中 最 丑陋 的 ， 而 且 各 
款 浏览 器 的 实现 又 是 那么 地 不 一 致 和 不 完整 。 也 难怪 过 去 十 年 里 许多 程序 员 都 没有 
把 JavaScript 认 作 一 门 “严肃 ”的 语言 。 最 近 ，Douglas 关于 JavaScript 好 处 (the 
good parts) 的 论述 让 人 们 认识 到 这 门 语言 虽 有 准 病 ， 但 仍 存 在 许多 宝贵 之 处 ， 因 而 
带动 了 此 语言 的 振兴 。 


在 2012 年 的 今天 ， 有 越 来 越 多 的 JavaScript 专家 倡导 JavaScript 代码 应 当 精 心 编 
写 、 高 性 能 、 易 维护 。Douglas Crockford、Dion Almaer、Peter Paul Koch (PPK)、 
John Resig、Alex Russell、Thomas Fuchs 等 许多 专家 对 此 进行 了 研究 、 提 议和 加 
工 ， 其 中 最 主要 的 是 提供 了 程序 库 ， 这 些 程序 库 让 全 世界 成 千 上 万 的 专业 JavaScript 























译注 2: 正 浏 览 器 并 非 真 的 支持 JavaScript 或 ECMAScript， 它 支持 的 变种 叫 JScript。 近 年 来 ，JScript 完 
整地 支持 了 ECMA- Script3， 以 及 ECMAScript 5 的 部 分 特性 。 同 时 ，JScript 还 和 Mozilla 的 
JavaScript 一 样 实现 了 一 些 专 有 的 扩展 ， 并 且 增 加 了 某 些 非 ECMAScript 标准 的 特性 。 
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程序 员 能 以 追求 卓越 的 精神 去 从 事 自己 的 行业 。jQuery、YUI、Dojo、Prototype、 
Mootools、Sencha 等 许多 程序 库 部 署 在 各 个 网 站 上 供 大 量 用 户 每 日 使 用 。 在 
JavaScript 不 但 被 接受 ， 还 被 广泛 应 用 和 拥护 的 环境 下 ， 这 样 的 平台 也 许 比 Web 本 
身 更 为 宽广 。 当 这 么 多 的 程序 员 了 解 了 JavaScript 时 ， 这 样 的 普及 就 成 为 了 它 的 一 
个 明显 优势 。 


如 果 你 在 一 屋子 Web 程序 员 中 调查 他 们 使 用 什么 语言 ， 会 了 解 到 Java 和 PHP 是 最 
流行 的 ，Ruby 可 能 是 目前 次 流行 的 (或 者 说 至 少 和 Python 流行 程度 相当 ) ，Perl 则 
依然 有 许多 追随 者 。 但 几乎 可 以 肯定 ， 任 何 从 事 Web 开发 的 人 都 使 用 过 JavaScript。 
虽然 后 端 语 言 与 浏览 器 直接 割裂 开 来 ， 但 编程 这 事 儿 都 脱离 不 了 部 署 这 一 环节 。 各 
种 各 样 的 浏览 器 及 浏览 器 插件 允许 使 用 不 同 的 语言 ， 但 这 些 语言 都 不 足以 成 为 Web 
开发 的 通用 语言 。 现 在 我 们 面前 有 这 样 一 个 单一 且 通 用 的 Web 开发 语言 ， 我 们 怎样 
才能 把 它 放 到 服务 器 上 去 呢 ? 








1.3.3 浏览 器 之 战 2.0 

在 互联 网 初期 ， 我 们 就 经 历 了 恶名 昭著 的 浏览 器 之 战 。Internet Explorer 和 Netscape 
在 Web 功能 上 竞争 激烈 ， 他 们 分 别 在 各 自 的 浏 览 右 上 添加 各 种 不 兼容 别人 的 编程 特 
性 ， 而 且 不 支持 其 他 浏览 器 所 具备 的 功能 。 对 于 那些 编写 Web 程序 的 开发 者 来 说 ， 
这 些 都 是 苗 问 的 来 源 ， 因 为 这 使 得 Web 开发 非常 烦琐 。Internet Explorer 或 多 或 少 
成 为 了 该 轮 竞争 的 胜 者 ， 变 成 了 主流 浏览 妖 。 几 年 之 后 ， 当 微软 在 IE6 上 看 足 不 前 
的 时 候 ， 出 现 了 一 个 新 的 竞争 者 : 从 Netscape 的 旧 成 员 中 诞生 的 Firefox。Firefox 
让 浏览 器 市 场 风 云 再 起 ，WebKit (Safari) 和 Chrome 紧 跟 其 后 。 甚 中 最 有 趣 的 还 是 
在 浏览 器 市 场 中 新 的 竞争 情况 。 


与 浏览 器 之 战 的 第 一 轮 交 锋 不 同 ,今天 的 浏览 器 主要 争夺 两 个 战场 : 一 是 坚持 上 一 
次 浏览 器 战争 后 出 现 的 标准 ， 二 是 性 能 。 随 着 网 站 越 来 越 复杂 ， 用 户 都 想 要 最 快 的 
体验 。 这 意味 着 ， 浏 览 器 不 但 要 很 好 地 支持 Web 标准 和 人 允许 开发 者 进行 优化 ， 还 要 
尽力 在 自己 内 部 进行 优化 。 以 JavaScript 为 核心 模块 的 Web 2.0 时 代 ，AJAX 网 站 
已 经 成 为 新 的 战场 。 








每 个 浏览 器 都 有 各 自 的 JavaScript 解析 器 : Firefox 的 Spider Monkey、Safari 的 
Squirrel Fish Extreme、Opera 的 Karakan， 最 后 还 有 Chrome 带 来 的 V8。 这 些 解 析 
器 不 断 追 求 更 快 的 性 能 ， 也 为 JavaScript 制造 了 创新 的 环境 。 为 了 让 自己 的 浏览 器 
突围 而 出 ， 厂 商 们 将 尽 最 大 能 力 让 它 运行 得 越 来 越 快 。 
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编写 有 趣 的 应 用 





过 去 几 年 ， 编 程 变化 的 趋势 是 让 复杂 的 应 用 变 得 越 来 越 容 易 开 发 。 我 们 当然 不 能 错 
过 此 等 好 事 ， 而 Node 是 专注 于 创建 网 络 应 用 的 ， 网 络 应 用 就 需要 许多 IO (输入 / 
HH) 操作 。 让 我 们 一 起 创建 几 个 IO 应 用 ， 来 看 看 使 用 Node 有 多 人 么 简单 ， 并 且 
能 轻松 扩展 规模 。 


2.1 创建 一 个 聊天 服务 器 


我 们 生活 在 一 个 实时 的 世界 里 ， 有 什么 比 聊天 更 加 实时 吗 ? 那 就 让 我 们 先 写 一 个 基 
于 TCP 的 聊天 服务 器 吧 ， 并 且 支 持 Telnet 连接 。 这 很 容易 ， 而 且 能 够 完全 用 Node 
来 编写 。 








AH 
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首先 ， 我 们 需要 在 Node 中 包含 TCP 模块 ， 并 创建 一 个 新 的 TCP 服务 器 ( 例 2-1)。 
例 2-1 创建 新 的 TCP 服务 器 
var net = require('net') 
var chatServer = net.createServer() 
chatServer.on('connection', function(client) { 
client.write('Hi!l\n'); 


client.write('Bye!\n'); 


client.end() 


} 


chatServer.listen(9000) 


代码 第 一 行 ， 我 们 加 载 了 net 模块 。 这 个 模块 包含 了 Node 需要 的 所 有 TCP 功能 。 
接着 ， 我 们 调用 net .createServer() 方法 来 创建 一 个 新 的 TCP 服务 器 。 有 了 这 
个 服务 器 ， 我 们 需要 用 它 做 点 儿 事 。 这 里 调用 on () 方法 来 添加 一 个 事件 监听 器 。 
每 当 有 新 的 客户 端 通过 网 络 连接 接 入 服务 嚣 ， 就 会 触发 connection 事件 ， 事 件 监 
听 器 就 会 调用 我 们 指定 的 函数 。 


连接 事件 在 调用 回调 函数 时 ， 会 传 给 我 们 新 客户 端 所 对 应 的 TCP socket 对 象 的 引 
用 。 我 们 把 此 引用 命名 为 client。 调 用 client .write()， 就 能 发 送信 息 给 该 客 
户 端 。 目 前 ， 我 们 只 是 简单 地 发 送 “Hi!” 和 “Bye!”， 然 后 调用 client .end() 方 
法 来 关闭 连接 。 就 这 么 人 简单， 我 们 的 聊天 服务 器 已 经 初 露 端 侈 了 。 最 后 ， 需 要 调用 
listen() 函数 ， 好 让 Node 知道 监 昕 哪个 端口 。 让 我 们 马上 测试 一 下 吧 。 

我 们 可 以 使 用 Telnet (大 多 数 操作 系统 都 自 带 此 程序 ) 来 连接 新 服务 器 进行 测 


试 。 首 先 ， 调用 node 命令 并 带 上 文件 名 来 启动 服务 器 。 然 后 ， 打 开 Telnet 连接 到 
localhost 的 9000 端口 (这 是 我 们 在 Node 程序 中 指定 的 端口 )。 见 例 2-2。 





例 2-2 用 Telnet 连接 Node TCP 服务 器 


Console Window 1h 
Enki:~ $ node chat.js 
Chat server started 


Console Window 2 

Last login: Tue Jun 7 20:35:14 on ttys000 
Enki:~ $ telnet 127.0.0.1 9000 

TEyirndg L27000 1s ss 

Connected to localhost. 

Escape character is '”*]'. 


Hil 

Bye! 

Connection closed by foreign host. 
Enki:~ $ 


到 目前 为 止 ， 我们 创建 了 一 个 服务 器 ， 它 能 够 接受 客户 端的 连接 ， 并 且 在 断 开 连 接 
前 发 送 了 一 小 段 内 容 。 但 这 还 不 能 称 为 聊天 服务 器 ， 我 们 再 来 添加 几 个 功能 吧 。 首 
先 ， 需要 能 收 到 客户 端 发 送 的 消息 ( 例 2-3)。 
例 2-3 监听 所 有 的 连接 请 求 

var net = require('net') 


Var chatServer = net.createServer() 
chatServer.on('connection', function(client) { 














注 1: 如 果 是 在 Windows 上 ， 我 们 推荐 使 用 免费 的 Putty 程序 来 作为 一 个 Telnet 客 广 


下 
菲 
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Client .write('HilNn') 
client.on('data', function (data) { 
console.1log (data) 
月 
}) 


chatServer.listen(9000) 





这 里 添加 了 另外 一 个 事件 监听 器 ， 调 用 的 是 client .on()。 注 意 ， 我 们 是 在 
connection 回调 函数 的 作用 域 中 添加 的 这 个 事件 监听 器 ， 这 样 就 可 以 访问 到 连接 
事件 所 对 应 的 client 对 象 。 新 监听 器 关注 的 是 data 事件 ， 每 当 client 发 送 数 据 
给 服务 器 时 ， 这 一 事件 都 会 被 触发 。 接 着 要 删 掉 client .end() 这 一 行 。 如 果 关 闭 
了 和 客户 端的 连接 ， 又 如 何 获得 新 的 数据 呢 ? (当然 , 说 “再 见 ” 那 一 行 同样 也 删 
邱 了 。) 现在 ， 无 论 我 们 发 任何 数据 给 服务 器 ， 它 都 会 在 终端 打印 出 来 。 让 我 们 看 看 
例 2-4。 


例 2-4 从 Telnet 发 送 数据 到 服务 器 


Console 1 








Enki:~ $ node chat.js 
Chat server started 
<Buffer 48 65 6c 6c¢ 6f 2¢ 20 79 6f 75 72 73 65 6C 66 0d 0a> 


Console 2 


Enki:~ $ telnet 127.0.0.1 9000 

TrYing T2700 Lis 

Connected to localhost. 

Escape character is '”*]'. 

Hi! 

Hello, yourself 
发 生 什么 事情 了 ? 我 们 运行 服务 器 并 用 Telnet 连 上 了 它 。 服 务 器 发 送 “Hi!”"， 然 后 
我 们 回应 “Hello, yourself”。 这 个 时 候 ，Node 吐出 了 一 堆 你 从 来 没有 见 过 的 看 似 
无 用 的 数据 。 原 来 ， 因 为 JavaScript 无 法 很 好 地 处 理 二 进 制 数据 ， 所 以 Node 特地 
增加 了 一 个 Buffer 库 来 帮助 服务 器 。Node 并 不 知道 Telnet 发 送 的 是 什么 类 型 的 
数据 ， 所 以 在 我 们 告诉 它 该 用 什么 编码 前 ，Node 只 能 保存 原始 的 二 进 制 格式 。 打 
印 的 字符 信息 实际 是 十 六 进 制 字 节 数据 〈 详 见 4.3.3 节 )。 每 个 字 节 对 应 着 字符 串 
“Hello, yourself” 中 的 一 个 字母 或 字符 。 如 果 需 要 ， 可 以 调用 tostring () 方法 来 
把 Buffer 数据 翻译 为 可 读 的 字符 串 格 式 ， 不 需要 的 话 ， 也 可 以 保持 二 进 制 格式 ， 
因为 TCP 和 Telnet 都 能 处 理 它 。 
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现在 我 们 能 够 接收 客户 端 发 送 的 消息 了 ， 接 下 来 要 做 的 事情 是 让 它们 互相 发 送 消息 。 
要 完成 此 功能 ， 需 要 让 它们 互相 通信 。 之 前 我 们 采用 的 是 client .write() 方法 ， 
可 惜 它 只 能 和 一 个 客户 端 通信 ， 而 我 们 需要 照顾 到 所 有 客户 端 。 为 此 可 以 创建 一 个 
列表 ， 然 后 把 希望 与 之 通信 的 客户 端 都 添加 进去 。 当 一 个 新 的 客户 端 出 现时 ， 就 把 
它 添 加 到 列表 中 ， 然 后 利用 此 列表 实现 客户 端 之 间 的 通信 ( 例 2-5)。 





例 2-5 客户 端 之 间 的 通信 
var net = require('net') 


var chatServer = net.createServer(), 
clientList = [] 


chatServer.on('connection', function(client) { 
client.write('Hi!l\n'); 


clientList.pushl(client) 


client.on('data', function (data) { 
for(var i=0;i<clientList.length;i+=1) { 
// 把 数据 发 送 给 所 有 客户 端 


clientList[i] .write (data) 





}) 

}) 

chatServer.listen(9000) 
我 们 来 看 看 例 2-6， 现 在 可 以 连接 多 个 客户 端 到 服务 器 上 ， 看 看 它们 是 如 何 互相 发 
消息 的 。 
例 2-6 客户 端 互 相 发 消息 


Console 1 





Enki:~ $ node chat.js 


Console 2 


Enki:~ $ telnet 127.0.0.1 9000 
TEY1NGg 127.0.0 Ls 

Connected to localhost. 

Escape character is '”*]'. 

Hi! 

Hello, yourself 

Hello, yourself 


Console 3 





Enki:~ $ telnet 127.0.0.1 9000 

Tying oO 0s Les 

Connected to localhost. 

Escape character is '^]'. 

Hi! 

Hello, youtrself 
这 次 ， 服 务 器 没有 记录 它 收 到 的 任何 消息 ， 而 是 把 列表 中 的 每 个 客户 端 都 轮 询 一 
遍 ， 并 把 消息 转发 出 去 。 值 得 注意 的 是 ， 当 终端 2 发 送 消 息 后 ， 消 息 转发 到 了 终端 
3 的 Telnet 客户 端 上 ， 同 时 也 发 回 给 终端 2 的 Telnet 客户 端 。 这 是 因为 我 们 在 发 送 
消息 的 时 候 ， 并 没有 检查 发 送 者 是 谁 ， 只 是 简单 地 把 消息 转发 给 所 有 客户 端 。 而 且 . 
Telnet 客户 端 也 无 法 区 分 哪些 消息 是 自己 发 送 的 ， 哪 些 消息 是 别人 发 送 的 。 我 们 需 
要 改进 一 下 。 在 例 2-7 中 ， 我 们 创建 一 个 函数 ， 处 理发 送 给 所 有 客户 端的 消息 并 解 
决 这 些 问 题 。 


例 2-7 改进 消息 发 送 


Var net = require('net') 











Var chatServer = net.createServer(), 
clientList = [] 


chatServer.on('connection', function(client) { 
client.name = client.remoteAddress + ':' + Client.remotePort 
client.write('Hi ' + client.name + '!\n') 


clientList.push(client) 


client.on('data', function (data) { 
broadcast (data, client) 


}) 
}) 


function broadcast (message, client) { 
for(var i=0;i<clientList.length;i+=1) { 
if(client !== clientList[i]) { 
clientList([i] .write(client.name + " says " + message) 


} 
} 
} 


chatServer.listen(9000) 


首先 ， 在 connection 事件 监听 器 上 为 每 个 client 对 象 增加 name 属性 。 为 什么 
我 们 能 为 client 对 象 添加 属性 呢 ? 因为 朵 包 绑 定 了 每 个 client 对 象 和 相应 的 请 
求 。 于 是 ， 在 闭 包 内 就 可 以 利用 client .remoteAddress 和 client .remotePott 
来 创建 client 的 name 属性 ， 其 中 client .remoteAddress 是 客户 端 所 在 的 卫 
地 址 ，client .remotePort 是 客户 端 接收 从 服务 器 返回 数据 的 TCP 端口 。 当 不 同 
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的 客户 端 从 同一 个 开发 起 连接 时 ， 它 们 各 自 会 有 唯一 的 remotePort。 以 后 再 向 
client 发 送 消息 时 ， 我 们 就 能 用 此 唯一 标识 来 找到 它 。 


我 们 还 把 处 理 aata 的 事件 监听 器 代码 抽 离 到 了 broadqcast 国 数 中 。 这 样 ， 通 过 
调用 broadcast 函数 就 可 以 把 消息 发 送 给 所 有 客户 端 。 这 一 次 ， 我 们 把 发 起 消息 
(data) 的 client 对 象 也 传递 进去 ， 以 便于 把 它 从 接收 消息 的 客户 端 列表 中 排除 
掉 。 我 们 还 把 client .name 加 到 了 要 发 送 的 消息 上 ， 好 让 其 他 客户 端 清楚 消息 来 
源 。 现 在 看 看 这 个 改进 后 的 服务 器 的 运行 效果 ( 例 2-8)。 


例 2-8 运行 改进 后 的 聊天 服务 器 


Console 1 














Enki:~ $ node chat.js 


Console 2 


Enki:~ $ telnet 127.0.0.1 9000 
TYY1ng L127.50%05D 5 

Connected to localhost. 

Escape character is '”*]'. 

HI 127:050L3560221 

Hello 

127.0.0.1:56018 says Back atcha 


Console 3 


Enki:~ $ telnet 127.0.0.1 9000 
PE LN L270 0 Ls 

Connected to localhost. 

Escape character is '”*]'. 

Hi 127.0.0,1:56018! 
127:0.:0:51:56022 Says: Hello 
Back atcha 


现在 它 已 经 能 够 更 加 友好 地 提供 服务 了 ， 虽 然 还 不 是 很 完美 ， 但 进步 还 是 很 明显 
的 。 需 要 注意 ， 你 自己 运行 例子 的 时 候 所 看 到 的 端口 数字 几乎 肯定 和 例子 中 的 数字 
不 同 。 因 为 不 同 的 操作 系统 对 端口 范围 的 限制 不 一 样 ， 并 且 端 口 的 指定 与 你 已 经 使 
用 了 哪些 端口 有 关系 ， 有 点 随机 因素 在 里 面 。 也 许 你 已 经 发 现 了 ， 我 们 的 服务 器 有 
一 个 致命 的 缺陷 。 如 例 2-9 所 示 ， 如 果 其 中 一 个 客户 端 断 开 了 ， 服 务 器 就 会 出 大 


问题 o 














例 2-9 断 开 一 个 客户 端 会 导致 服务 器 出 错 


Console 1 


Enki:~ $ node book-chat.js © 


net.js:392 @ 

throw new Error('Socket is not writable'); 

x 

Error: Socket is not writable 

at Socket. writeOut (net.js:392:11) 

at Socket.write (net.js:378:17) 

at broadcast (/Users/shlimmer/book-chat.js:21:21) 

at Socket.<anonymous> (/Users/shimmer/book-chat.js:13:5) 

at Socket.emit (events.js:64:17) 

at Socket. onReadable (net.js:679:14) 

at IOWatcher.onReadable [as callback] (net.js:177:10) 
Enki:~ $ 


Console 2 


Enki:~ SS telnet 127.0.0.1 9000 ©@ 
Ty oa 0 Ls 

Connected to localhost. 

Escape character is '^]'. 

Hi T2700 11569101 

| 

telnet> gquit @ 

Connection closed. 

Enki:~ $ 


Console 3 


Enki:~ SS telnet 127.0.0.1 9000 9 
TY¥YLng T2700 aL iis 

Connected to localhost. 

Escape character is '^]'. 

Hi 12750.0. L1569L11 

You still there? © 

Connection closed by foreign host. © 
Enki:~ $ 


我 们 和 之 前 一 样 先 启动 服务 器 @， 然 后 连接 儿 个 客户 端 @@， 但 是 当 终 端 2 
中 的 客户 端 断 开 连 接 时 @， 麻 烦 就 来 了 。 如 有 果 终 端 3 再 发 送 消 息 @， 即 调用 
pbroadcast () 的 时 候 ， 服 务 器 会 往 一 个 已 经 断 开 的 客户 端 写 人 数据 @。 当 终端 2 的 
客户 端 断 开 的 时 候 @， 它 对 应 的 socket 已 经 无 法 写 入 或 读 取 了 。 而 对 已 经 关闭 的 
socket 进行 write () 操作 时 ，Node 程序 会 抛 出 异常 。 这 将 导致 其 他 所 有 客户 端 掉 
线 @。 显 然 ， 这 么 脆弱 的 程序 是 不 能 作为 服务 器 的 。 
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这 个 问题 应 该 从 两 方面 来 解决 。 首 先 必 须 保 证 在 一 个 客户 端 断 开 的 时 候 ， 要 把 它 从 
客户 端 列 表 中 移 除 ， 防 止 它 再 调用 write() 方法 。V8 引擎 也 会 把 相应 的 socket 对 
象 作为 垃圾 回收 ， 并 释放 相应 的 内 在 。 其 次， 要 采用 更 保险 的 方式 调用 write () 方 
法 。 我 们 要 确保 socket 从 上 次 被 写 入 到 现在 ， 没 有 发 生 任何 阻碍 我 们 调用 write () 
方法 的 事情 。 好 在 用 Node 很 容易 做 到 这 两 点 。 第 一 点 的 详细 做 法 见 例 2-10。 


例 2-10 把 聊天 服务 器 改造 得 更 加 健壮 


chatServer.on('connection', function(client) { 
client.name = client.remoteAddress + ':' + client.remotePort 
client.write('Hi ' + client.name + '!\n'); 


























clientList.pushl(client) 


client.on('data', function (data) { 
broadcast (data, client) 


}) 


client.on('end', function() { 
clientList.splice(clientList.indexOf (client), 1) 
}) 
}) 





我 们 先 处 理 断 开 连 接 的 客户 端 。 当 一 个 客户 端 断 开 时 ， 要 把 它 从 客户 端 列 表 中 移 除 。 
这 可 以 利用 enda 事件 来 完成 。 一 个 socket 断 开 连接 时 会 触发 enda 事件， 表示 它 要 关 
闭 。 此 时 ， 调 用 Array.splice() 将 客户 端 从 clientList 列表 中 移 除 。Array. 
indexof () 方法 用 于 找到 客户 端 在 列表 中 的 位 置 ， 然 后 splice () 把 它 从 列表 中 移 
除 。 在 此 之 后 ， 下 一 个 客户 端 调用 proadcast 方法 时 ， 已 经 断 开 的 客户 端 将 不 会 再 
出 现在 列表 中 了 。 


此 外 ， 我 们 还 能 做 得 更 加 保险 ， 如 例 2-11 的 代码 所 示 。 
例 2-11 检查 socket 的 可 写 状态 


function broadcast (message, client) { 
var cleanup = [] 
for(var i=0;i<clientList.length;i+=1) { 
if(client !== clientList[i]) { 


if (clientList[i] .writable) { 
clientList[i] .write(client.name + " says " + message) 
} else { 
cleanup.push (clientList [i]) 
clientList[i] .destroy () 





} 
} 
// 在 写 入 循环 中 删除 死 节 点 ， 消 除 垃圾 索引 
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for (i=0;i<cleanup.length;i+=1) { 
clientList.splice(clientList.i 
} 
} 


ndexOof (cleanup [i] ), 1) 


调用 broadcast 函数 的 时 候 ， 检 查 一 下 socket 是 否 可 写 ， 以 确保 不 会 因为 任何 
一 个 不 可 写 的 socket 导致 异常 。 不 仅 如 此 ， 发 现任 何不 可 写 的 socket 后 ， 还 要 
通过 socket .destroy() 方法 将 其 关闭 并 从 clientList 中 移 除 。 注 意 ， 允 历 
clientList 的 过 程 中 并 没有 移 除 socket， 因 为 我 们 不 想 在 遍历 过 程 中 出 现任 何 未 





知 的 副作用 。 现 在 我 们 的 服务 器 更 加 健 闪 
理 ， 那 就 是 记录 这 些 错误 ( 例 2-12)。 





例 2-12 记录 错误 


chatServer.on('connection', 
client.name 
Client .write 


functe 
= client.remoteAddre 
('Hi ' + client.name 
console.log(client.name + ' 


clientList.push(client) 


client.on('data', 
broadcast (data, 


} 


function(data) 
client) 


client.on('end', function() 
console.log(client.name + qu 
clientList.splice(clientList.i 


} 


{ 


client.on('error', function(e) 
console.1log(e) 


} 
} 


为 client 对象 的 error 事 


{ 




















了。 在 真正 部 署 之 前 ， 还 有 一 件 事 情 要 处 


on(client) { 


SS + + Client.remotePort 
+ "Il\n'); 


joined') 


人 


下 攻 7 


ndexOf (client), 1) 


件 添加 了 console.1og() 调用 后 ， 可 以 确保 客户 端 发 


生 的 任何 错误 都 会 被 记录 下 来 。 而 之 前 增加 的 代码 ， 则 能 够 确保 在 客户 端 抛 出 错误 





的 时 候 ， 不 会 因为 异常 而 导致 服务 器 停止 


o 


2.2 ”我们 也 来 编写 个 Twitter 


前 一 个 例子 展示 了 用 Node 编写 一 个 实时 应 用 有 多 么 容易 。 当 然 ， 你 有 时 候 还 要 开 
发 Web 应 用 。 让 我 们 用 Node 来 创建 一 个 类 似 Twitter 的 Web 应 用 。 首 先 ， 我们 需 
要 安装 Express 模块 ( 例 2-13)。 这 个 针对 Node 的 Web 框架 为 现 有 的 http 服务 器 


模块 添加 了 更 多 的 扩展 (如 MVC)， 使 开 


发 Web 应 用 更 加 简单 。 
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例 2-13 安 h 装 Express 模块 


Enki:~ $ npm install express 
express@2.3.12 ./node modules/express 
六 一 mime@1.2.2 

FF Commecet®l ,5:1 

qs@0.1.0 

Enki:~ $ 


使 用 Node 包 管理 程序 (npm) 可 以 很 容易 地 安装 Express。 一 旦 安装 好 了 此 框架 ， 就 
能 创建 一 个 基本 的 Web 应 用 ( 例 2-14)。 这 个 程序 和 我 们 第 1 章 所 编写 的 例子 很 像 。 











a 
， 


$v 你 可 以 在 第 6 章 和 第 7 章 了 解 更 多 关于 npm 的 知识 。 


人 








例 2-14 使 用 Express 的 基本 Web 服务 器 


Var express = require('express') 
var app = express .etfeateSexveE (OO 


app.get ('/', function(req, res) { 
res.send('Welcome to Node Twitter') 


}) 
app.listen(8000) 


这 段 代 码 和 第 1 章 中 的 Web 服务 器 代码 范例 像 极 了 ， 只 是 我 们 引入 了 express 模 
块 而 不 是 http 模块 。Express 会 在 后 台 调 用 http 模块 ， 因 为 Node 会 自动 解析 
依赖 关系 ， 所 以 我 们 不 需要 为 此 操心 。 和 使 用 http 或 net 模块 类 似 ， 我 们 调用 
Server () 来 创建 服务 器 ， 并 调用 1isten () 来 监听 指定 端口 。 不 需要 用 Express 为 
请 求 事件 指定 监听 器 ， 而 是 可 以 通过 HTTP 匹配 的 方式 来 调用 对 应 的 方法 。 这 个 例 
子 中 ， 调 用 get () 方法 时 ， 我 们 为 匹配 第 一 个 参数 所 指定 URL 的 GET 请 求 指定 了 
回调 函数 。Express 增加 了 两 样 http 模块 所 没有 的 功能 : 根据 HTTP 请 求 的 不 同方 
法 进行 过 滤 ， 根 据 特定 的 URL 进行 过 滤 。 


至 于 回调 函数 ， 它 看 起 来 和 http 模块 的 方法 很 像 ， 实 际 上 就 是 一 样 的 。 此 外 ， 
Express 还 添加 了 若干 其 他 方法 。 采 用 http 模块 时 ， 我 们 需要 创建 HTTP 头 ， 并 且 
在 发 送 请 求 内 容 之 前 把 HITP 头 先 发 送 给 客户 端 。Express 提供 了 一 个 方便 的 方法 ， 
这 就 是 res (http.response) 对 象 的 send() 方法 。 此 方法 发 送 HTTP 头 ， 同 时 还 
会 调用 response .end () 方法 。 到 此 为 止 ， 我 们 这 个 例子 比 第 1 章 的 Hello World 
服务 器 例子 强 不 了 多 少 。 只 不 过 这 个 新 的 服务 器 只 响应 URL 为 “/” 的 GET 请 求 ， 
而 且 不 会 抛 出 错误 ， 第 1 章 的 例子 则 会 响应 任何 URL 和 任何 请 求 。 
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下 面 让 我 们 开始 为 服务 器 添加 一 些 类 似 Twitter 的 功能 吧 〈 例 2-15) 。 在 刚 开 始 的 时 


候 ， 我 们 先 不 去 管 健壮 性 或 者 扩展 性 。 假 设 不 用 考虑 这 些 问题 ， 好 让 你 看 清楚 





编写 一 个 应 用 。 


例 2-15 添加 基础 API 


Var express = require('express') 


var app = express.createServer() 
app.listen(8000) 


var tweets = [] 


app.get ('/', function(req, res) { 
res.send('Welcome to Node Twitter') 


} 


app.post('/send', express.bodyParser(), function(req, res) { 
if (req.body && req.body.tweet) { 

tweets.push (reqg.body .tweet) 

res.send({status:"ok", message:"Tweet received"}) 

else { 

// 没有 tweet? 

res.send({status:"nok", message:"No tweet received")}) 
} 

}) 


i 


app.get ('/tweets', function(reqg,res) { 
res.send (tweets) 


}) 
在 前 面 简单 的 Express 应 用 基础 上 ， 我 们 添加 了 几 个 国 数 来 提供 最 基础 的 API。 


如 何 


但 


先 看 一 下 我 们 做 的 另外 一 个 修改 。 我 们 把 app.1listen() 调用 移 到 了 文件 的 上 方 。 
为 什么 调用 放 到 前 头 不 会 导致 下 面 响应 请 求 的 函 ee 题 呢 ? 理解 这 一 点 非常 重要 。 
你 可 能 会 认为 ， 如 果 在 文件 开头 调用 app.1listen()， 那 么 从 调用 app.1isten() 
结束 到 解析 完 下 面 的 函数 这 段 时 间 里 ， Rs 这 样 的 想 























法 并 不 正确 原因 有 二 。 第 一 ，JavaScript 所 有 的 事件 触发 都 是 在 事件 循环 中 ， 

















这 


意味 着 除非 我 们 已 经 完成 了 这 次 循环 中 的 所 有 处 理 国 数 ， 否 则 新 的 事件 是 不 会 被 
触发 调用 的 。 对 这 个 例子 而 言 ， 除 非 我 们 已 经 把 文件 中 所 有 的 初始 化 代码 执行 完 ， 
否则 不 会 调用 request 事件 (从 而 也 就 不 会 调用 相应 的 处 理 函 数 )。 第 二 ， 








listen() 图 数 调用 是 异步 的 ， 因 为 绑 定 TCP 端口 也 需要 花 时 间 ， 而 其 他 ( 通 
app.get () 和 app.post() 指定 的 ) 事件 监听 器 则 是 同步 的 。 








我 们 通过 app.post () 方法 添加 “/send” 的 POST 路 由 来 提供 基础 的 tweet 功能 。 
这 个 函数 对 比 之 前 的 例子 有 些 难 懂 。 显 然 ， 这 是 一 个 app.post() 而 不 是 app . 

















get () 方法 ， 这 就 意味 着 它 接受 的 是 HTTP POST 请 求 而 不 是 HTTP GET 请 求 。 更 
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加 显著 的 不 同 点 是 ， 我 们 为 此 国 数 多 传人 了 一 个 参数 。 其 实 ， 你 不 需要 对 所 有 的 
app.post () 调用 都 做 这 个 操作 ， 其 至 可 以 全 都 不 传 此 参数 。 这 个 跟 在 url 后 面 的 
参数 是 个 中 间 件 。 


中 间 件 是 指 一 小 段 特 定 的 代码 ， 位 于 原始 请 求 事件 与 我 们 给 app .post () 指定 的 路 
由 之 间 。 我 们 通过 中 间 件 对 一 些 通用 功能 进行 代码 重用 ， 如 用 户 授权 或 者 log 记录 。 
在 本 例 中 ， 中 间 件 的 作用 是 把 客户 端 POST 的 数据 转换 成 我 们 能 够 使 用 的 JavaScript 
对 象 。 这 是 Express 本 身 就 自 带 的 podyParser 模块 。 我 们 在 指定 app .post () 路 
由 的 时 候 把 它 包含 进来 就 可 以 了 ， 就 是 调用 express .bodyParser () 。 这 个 国 数 调 
用 会 返回 另外 一 个 函数 。 这 种 调用 中 间 件 的 标准 方式 可 以 让 你 在 需要 的 时 候 指 定 中 
间 件 的 配置 。 


如 果 我 们 不 使 用 中 间 件 ， 就 需要 自己 动手 写 代 码 处 理 请 求 对 象 (res) 所 提供 的 数 
据 了 。 只 有 当 POST 传输 的 所 有 数据 都 接收 完了 ， 才 会 调用 app .post () 指定 的 函 
数 。 使 用 中 间 件 不 但 能 将 代码 重用 ， 还 使 代码 结构 更 加 清晰 。 


express.bodyParser 为 req 对 象 添 加 了 新 的 属性 ， 称 为 req.body。 这 个 属 
性 (如 果 它 存在 的 话 ) 包含 了 POST 数据 对 应 的 对 象 。express .bodyParser 中 
间 件 只 能 够 处 理 POST 方法 的 数据 ， 而 且 要 求 HTTP 头 的 content-type 属性 是 
application/x-www-form-urlencoded 或 application/json。 这 两 种 数 据 格 
式 都 能 够 很 容易 地 解析 成 key/value 值 ， 并 保存 到 reg .body 对 象 中 。 


在 app.post() 处 理 函 数 中 ,我们 第 一 步 要 先 检 查 express .bodyParser 是 否 找 
到 了 数据 ， 只 要 检查 一 下 req.body 是 否 存在 就 可 以 了 。 如 果 存 在 ， 我 们 查找 req. 
body .tweet 的 这 一 属性 ， 这 是 tweet 的 内 容 。 如 果 找 到 了 tweet， 就 把 它 记 录 在 一 
个 叫做 tweets 的 全 局 数组 中 ， 并 且 返 回 客户 端 一 个 JSON 字符 串 表 示 已 经 成 功 。 
如 果 没 有 找到 *ed.body 或 req.body.tweet， 就 返回 表示 失败 的 JSON 字 串 给 客 
户 端 。 注 意 ， 我 们 并 没有 在 调用 res .send() 时 对 数据 进行 序列 化 。 如 果 传 给 res. 
send() 一 个 对 象 ， 它 会 自动 把 其 序列 化 为 JSON 并 添加 对 应 的 HTTP 头 。 


最 后 ， 我 们 把 基础 的 API 补充 完整 ,添加 了 一 个 监 昕 “/tweets” 的 app.get () 路 
由 。 这 个 路 由 只 是 简单 地 把 tweets 数组 的 内 容 以 JSON 的 形式 返回 出 去 。 

我 们 可 以 写 一 些 测 试 来 确认 这 些 简 单 的 API 能 正常 工作 ( 例 2-16)。 即 使 你 不 是 采 
用 完整 的 测试 驱动 开发 《TDD)， 这 个 做 法 也 是 一 个 良好 的 习惯 。 




















例 2-16 测试 POST API 


var http = require('http'), 
assert = require('assert') 
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var opts = { 
host: 'localhost', 
Borts ‘3000 
path: '/send', 
method: 'POST', 
headers: {'content-type':'application/x-www-form-urlencoded'} 


} 


var req = http.request (opts, function(res) { 
res.setEncoding('utf8') 


Var data = "" 
res.on('data', function(d) { 
data += d 


} 


res.on('end', function() { 
assert.strictEqual (data, '{"status":"ok", "message":"Tweet eceived"}') 
}) 
}) 


req.write('tweet=test') 
req.end() 


我 们 需要 http 模块 来 发 送 HTTP 请 求 ， 然 后 用 assert 模块 对 返回 值 进行 测试 。 
assert 是 Node 的 一 个 核心 模块 ， 它 能 帮助 我 们 用 多 种 方式 来 对 返回 值 进行 测试 。 
当 一 个 值 与 预期 的 条 件 不 符 时 ， 将 抛 出 异常 。 通 过 测试 脚本 来 检查 程序 运行 时 应 该 
有 的 表现 ， 可 以 确保 它 的 功能 正确 。 


http 模块 并 非 只 包含 了 HTTP 服务 六 ea 它 同 时 还 提供 了 客户 端的 功能 。 在 这 
个 测试 程序 中 ， 我 们 使 用 pttp.request () 这 一 工厂 方法 来 创建 新 的 http 请 求 对 
象 ， 并 指定 了 options 这 个 参数 。 as options 的 一 系列 属性 ， 来 让 http. 
Request 对 象 按 我 们 的 要 求 运 行 。 在 创建 其 他 Node 对 象 的 时 候 ， 你 也 会 看 到 类 似 的 
配置 方法 。 在 上 面 的 例子 中 ， 我 们 指定 了 主机 名 (会 被 uns 解析 )、 端 口 、URL 路 径 、 
HTTP 方法 和 一 些 HTTP 头 。 这 些 信息 都 是 我 们 创建 Express 服务 器 所 采用 的 。 








http.request () 构造 函数 接受 了 两 个 参数 : 第 一 个 是 config 对 象 ， 第 二 个 是 回 
调 国 数 。 回 调 函 数 是 监听 在 http.Request 的 response 事件 上 的 。 这 与 http. 
Server 很 类 似 ， 但 这 里 返回 对 象 只 会 出 现 一 次 。 


我 们 处 理 返回 信息 的 第 一 步 是 调用 setEncoding () 方法 。 这 就 让 我 们 指定 了 所 有 
接受 数据 的 编码 方式 。 通 过 设置 为 utf8， 我 们 确保 接收 的 数据 都 被 正确 地 处 理 为 需 
人 下 一 步 我 们 定义 了 一 个 变量 aata， 用 它 以 流 式 方式 处 理 来 自 服务 

器 的 所 有 响应 数据 。 在 Express 服务 器 a ， 我 们 用 了 express .bodyDecoder 来 处 














注 2: 你 可 以 在 第 5 章 获 得 更 多 关于 assert 模块 的 信息 
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理 请 求 数据 流 中 所 有 的 内 容 ， 但 在 客户 端 我 们 没有 这 么 高 级 的 工具 ， 所 以 需要 手动 
处 理 流 数据 。 其 实 这 也 非常 简单 ， 只 需 指定 响应 返回 时 的 aata 事件 监听 函数 。 当 
一 部 分 数据 到 达 时 ， 把 它 追 加 到 aata 变量 上 就 行 了 。 同 时 ， 我 们 监听 响应 的 sna 
事件 ， 以 便 在 所 有 数据 都 到 达 后 采取 行动 。API 之 所 以 设计 成 这 种 方式 ， 是 因为 许 
多 应 用 可 以 利用 它 来 进行 数据 流 的 操作 ， 也 就 是 可 以 一 边 接 收 数据 一 边 处 理 ， 而 不 
需要 先 等 待 所 有 数据 都 发 送 完 成 再 操作 。 


只 有 当 我 们 把 服务 器 返回 的 数据 接收 完整 后 ，end 事件 才 会 被 触发 。 现 在 我 们 可 以 
对 服务 器 返回 的 数据 进行 测试 了 。 测 试用 例 中 将 检查 aata 变量 中 的 数据 是 否 和 我 
们 预期 服务 器 会 发 送 的 内 容 一 致 。 如 果 服 务 器 运行 正常 ， 它 将 返回 一 个 JSON 数据 。 
利用 assert .strictEgqual 国 数 ， 我 们 能 对 数据 进行 “===” 级 别 的 一 致 性 检查 。 
如 果 检 查 条 件 不 满足 要 求 ， 就 会 抛 出 异常 。 因 为 要 模拟 网 页 表单 的 操作 ， 所 以 需要 
采用 x-www-form-urlencoded 格式 发 送 数 据 。 


现在 我 们 准备 好 了 请 求 对 象 和 相关 的 事件 处 理 函 数 ， 下 一 步 是 往 服务 器 发 送 数 据 。 
我 们 调用 write() 函数 来 发 送 数 据 (因为 这 是 一 个 POST 请 求 )， 通 过 发 送 一 些 测 
试 数据 来 检查 服务 器 的 响应 内 容 是 否 正确 。 最 后 ， 调 用 ena () 方法 来 表示 数据 已 经 
发 送 完 毕 。 

运行 这 个 脚本 ， 它 将 连接 到 我 们 启动 好 的 服务 器 (如 果 它 正在 运行 ) 并 发 送 POST 
请 求 。 如 果 它 接收 到 了 正确 的 数据 ， 就 会 静 静 地 退出 。 反 之 ， 如 果 它 连接 不 上 服务 
器 ， 或 者 服务 器 返回 的 内 容 不 是 预期 的 数据 ， 脚 本 将 抛 出 异常 。 编 写 这 些 测 试 脚 本 
的 目的 ， 就 是 检查 服务 器 是 否 达 到 了 设计 要 求 。 


有 了 这 个 API 以 后 ， 我 们 就 能 进一步 开发 Web 界面 来 供用 户 使 用 了 。 现 在 功能 还 很 
基础 ， 但 API 已 经 能 让 用 户 向 所 有 人 发 送 消息 了 。 让 我 们 来 写 个 界面 吧 。 


Express 围绕 着 请 求 路 由 的 方式 支持 MVC 结构 (模型 ， 视 图 ， 控 制 器 )。 控 制 路 
由 与 控制 器 类 似 ， 提 供 了 把 数据 模型 和 视图 相 结 合 的 方法 。 我 们 已 经 使 用 过 路 由 
(app.get ('/'， function))。 在 例 2-17 的 文件 夹 结构 中 ， 存 放 了 视图 的 不 同 部 
分 。 通 常 ，views 文件 夹 存放 的 是 视图 模版 ， 在 其 中 的 partials 文件 夹 中 包含 的 是 子 
模版 (在 后 面 会 详细 介绍 )。 对 于 不 使 用 内 容 分 发 网 络 (CDN) 的 应 用 ，public 文件 
夹 存 放 的 是 静态 文件 ， 如 CSS 和 JavaScript。 


例 2-17 Express 应 用 的 基本 文件 夹 结构 
































mm app.js 
[一 一 blic 








Views 
[一 partials 
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要 把 我 们 简单 的 模型 (var tweets = []) 连接 到 视图 中 ， 需 要 先 创 建 一 些 视图 。 
首先 在 views 文件 夹 下 创建 视图 文件 。Express 提供 了 几 种 不 同 的 模版 语言 ， 并 且 可 
以 为 其 扩展 更 多 类 型 。 我 们 首先 采用 EJS 模版 语言 *。EJS 是 通过 把 JavaScript 腾 入 
在 模版 中 ， 并 提供 了 一 些 简单 的 标签 来 定义 JavaScript 该 如 何 解析 运行 。 我 们 来 看 
一 个 EJS 的 例子 ， 先 由 例 2-18 中 的 layout 文件 开始 。 
例 2-18 EJS 布局 模板 文件 

<!IDOCTYPE html> 


<html lang="en"> 
<head> 





<meta charset="utf-8"> 
<$- partial('partials/stylesheet', stylesheets) 各 > 
<title><%= title %></title> 
</head> 
<body> 
<hl><%$= header %$></h1l> 
<%- body %> 
</body> 
</htmls 


Express 的 layout 文件 定义 了 网 站 的 骨架 。 它 是 你 在 几乎 所 有 地 方 都 需要 使 用 的 基 
本 视图 样式 。 在 本 例 中 ， 我 们 采用 了 一 个 非常 简单 的 HTML5 页 面 。 页 面 头 部 包含 
了 一 些 样式 表 定 义 ， 然 后 是 正文 内 容 。 正 文 包含 了 一 个 hl 头 元 素 和 其 他 一 些 内 容 。 
注意 <-$ 标签 ， 这 是 我 们 将 插入 JavaScript 变量 的 地 方 。 在 <-$ 和 *> 标签 之 间 的 
JavaScript 会 被 执行 。 我 们 后 面 会 再 详细 介绍 这 些 以 = 或 - 开头 的 标签 。 通 常 ， 你 
只 需要 引用 一 些 数据 (如 变量 或 引用 ) 放 到 页 面 中 来 ， 比 如 , <h1><%= header %> 
</hli> 将 neader 变量 包含 在 了 hl 元 素 中 。 


模版 中 有 两 个 特殊 的 地 方 。 第 一 个 是 partial () ，Partial 是 一 些 迷 你 模版 ， 可 以 通 
过 指定 不 同 的 数据 重复 使 用 。 例 如 ， 你 可 以 想象 一 篇 博客 的 评论 内 容 ， 它 就 是 一 段 
固定 的 HTML 格式 重复 了 许多 过 ， 只 是 其 中 的 评论 者 和 评论 内 容 不 一 样 。Partial 是 
保存 可 重复 利用 的 代码 片段 的 地 方 ， 它 独立 于 使 用 它 的 页 面 ， 这 样 在 更 改 时 只 需要 
修改 一 个 地 方便 能 同时 改变 所 有 页 面 的 样式 。 另 外 一 个 特殊 的 用 法 是 body 变量 。 
因为 我 们 在 网 站 的 所 有 页 面 都 用 了 这 个 layout 格式 (除非 主动 关闭 它 )， 所 以 需要 
有 一 些 方法 来 指定 不 同 页 面 所 需要 泻 染 的 内 容 。Express 为 此 提供 了 body 变量 ， 这 
个 变量 包含 了 我 们 想 要 泻 染 的 模版 。 

在 继续 查看 其 他 模版 之 前 ， 我 们 先 指定 一 个 路 由 来 调用 render 函数 生成 页 面 看 看 
效果 〈 例 2-19)。 





























注 3: 第 7 章 会 介绍 更 多 Express 的 模版 语言 。 
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例 2-19 为 '/' 路 由 泻 染 index 模板 


app.get ('/', function(req, res) { 
var title = 'Chirpie', 
header = 'Welcome to Chirpie' 


res.render('index', { 
locals: { 
'title': title, 
'header': header, 
'tweets': tweets, 
stylesheets: ['/public/style.css'] 


}) 
}) 
这 个 路 由 处 理 的 代码 和 我 们 之 前 使 用 的 其 他 路 由 代码 类 似 ， 只 不 过 这 次 不 是 调用 
res.send()， 而 是 调用 res .render() 函数 来 泻 染 一 个 模版 。 第 一 个 参数 是 我 们 
想 要 演 染 的 模版 的 名 字 。 需 要 记 住 ， 无 论 index 模版 演 染 成 什么 样子 ， 它 都 会 放 入 
layout 模版 中 body 变量 所 在 的 位 置 。 传 给 res .render() 的 第 二 个 参数 是 配置 对 
象 ， 这 里 我 们 并 未 作 任 何 配置 ， 只 指定 了 一 些 本 地 变量 。 配 置 对 象 中 的 locals 属 
性 包含 了 需要 这 染 此 模版 的 数据 。 我 们 指定 了 title、header、tweets 数组 和 
stylesheets 数组 ， 所 有 这 些 变量 都 在 layout 和 index 模版 中 使 用 了 。 


我 们 需要 在 index 模版 中 定义 泻 染 tweet 的 方法 ， 好 让 用 户 能 够 看 见 所 有 提交 的 消息 
( 例 2-20) 。 我 们 不 会 单独 显示 每 条 tweet 流 数 据 ， 而 是 会 提供 一 个 页 面 ， 让 每 个 人 
都 能 看 到 所 有 提交 的 内 容 ， 并 可 以 通过 API 提交 各 自 的 消息 。 














例 2-20 展示 tweet 和 让 用 户 提 交 新 tweet 的 index 模板 


<form action="/send" method="POST"> 
<input type="text" length="140" name="tweet"> 
<input type="submit" value="Tweet"> 

</form> 

<$- partial('partials/chirp', tweets) %> 


这 个 index 模版 非常 简单 。 我 们 提供 了 一 个 短 的 表单 来 输入 新 的 tweet 信息 。 这 是 普 
通 的 HTML 方法 ， 之 后 可 以 改 为 使 用 AJAX 方法 。 接 着 是 泻 染 tweet 用 的 partial 模 
版 。 因 为 它们 都 是 一 样 格式 的 ， 我 们 不 想 在 index 模板 里 使 用 丑陋 的 循环 把 标记 租 
入 进去 。 通 过 使 用 partial 模版 ， 我 们 把 呈现 tweet 的 简短 模版 抽象 出 来 ， 在 需要 的 
地 方 重复 利用 。 这 样 做 能 够 保持 代码 的 美观 和 简洁 。 我 们 还 能 在 之 后 增加 更 多 的 功 
能 ， 但 现在 已 经 提供 了 所 需要 的 基本 功能 了 。 我 们 还 需要 定义 在 layout 和 index 模 
版 中 用 到 的 partial 模版 (参见 例 2-21 和 例 2-22)。 


例 2-21 演 染 chirp 的 partial 模版 


<p><%$= chirp %$></p> 
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例 2-22 这 染 stylesheet 的 partial 模版 


<link rel="stylesheet" type="text/css" href="<%- stylesheet %>"> 


这 两 个 模版 都 超级 简单 ， 他 们 接收 一 些 输入 数据 然后 插入 指定 的 地 方 。 因 为 传人 的 参 
数 是 一 个 数组 ， 所 以 模版 泻 染 时 会 自动 遍历 数组 中 的 每 一 个 元 素 。 这 里 并 没有 什么 高 
深 的 做 法 。 每 个 子 模版 接收 的 数组 变量 名 称 和 模版 的 名 称 一 致 ， 如 名 叫 chirp 的 模版 
访问 的 数据 变量 名 称 也 叫 cnirp。 例 子 中 的 数据 都 是 简单 的 字符 串 ， 如 果 我 们 传 入 的 
是 一 组 对 象 ， 可 以 通过 chirp.property 或 者 chirp['property'] 的 方法 来 获得 这 
些 对 象 对 应 的 propery 名 称 的 属性 。 当 然 ， 你 还 能 调用 方法 ， 如 chirp.method ()。 


现在 ， 我 们 的 应 用 允许 用 户 提交 tweet 了 。 它 很 简单 ， 但 还 有 一 些 地 方 可 以 改进 。 
让 我 们 现在 就 改正 这 些 问题 吧 。 第 一 个 显然 的 问题 是 ， 当 我 们 提交 新 的 tweet 时 ， 
会 进入 到 发 生 JSON 对 应 的 处 理 代码 。 虽 然 我 们 访问 URL 的 路 径 为 /send 没什么 
大 问题 ， 但 对 服务 器 来 说 不 应 该 对 所 有 用 户 一 视 同仁 。 而 且 tweet 只 是 按时 间 顺 序 
加 入 ， 缺 少 了 时 间 惟 ,我们 无 法 知道 它们 的 新 旧 程度 。 我 们 也 需要 解决 这 个 问题 。 


处 理 /sena 路 径 很 简单 。 当 HTTP 客户 端 发 送 请 求 时 ， 它 可 以 指定 想 要 返回 的 数据 
格式 。 通 常 浏览 器 会 优先 请 求 cext /html 格式 ， 再 芳 虑 其 他 格式 。 然 而 ， 在 调用 
API 请 求 时 ， 客 户 端 可 能 会 指定 application/json 格式 来 获得 需要 的 输出 内 容 。 
通过 检查 HTTP 头 的 accept 字段 ， 我 们 可 以 确定 对 于 浏览 器 返回 的 是 主页 ， 而 
API 客户 端 收 到 的 是 JSON。 











HTTP 头 的 accept 字段 可 能 是 text/html,application/xhtml+xml,application/ 
xml;q=0.9,*/*; gqg=0.8。 这 是 从 Chrome 浏览 器 发 送 上 来 的 ， 包 含 了 一 连 串 以 逗号 分 
隔 的 MIME 类 型 。 我 们 首先 需要 一 个 小 方法 来 确定 text/html 是 否 在 accept 字段 中 
( 例 2-23) ， 然 后 根据 测试 的 结果 执行 不 同 的 逻辑 。 


例 2-23 检查 accept 头 是 否 包含 text/html 的 小 函数 


function acceptsHtml (header) { 
var accepts = header.split(',') 
for (i=0;i<accepts.length;i+=0) { 
if (accepts[i] === 'text/html') { return true } 


} 
return false 
} 
这 个 函数 把 头 字 段 根据 逗号 切 制 成 数组 ， 然 后 遍历 这 些 字 段 ， 看 其 中 是 否 有 字段 与 
text/html 匹配 ， 有 则 返回 true， 否 则 返回 false。 我 们 通过 这 个 函数 来 区 分 请 
求 来 源 是 浏览 器 还 是 API ( 例 2-24)。 
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例 2-24 重 定向 浏览 器 到 /send 


app.post('/send', express.bodyParser(), function(req, res) { 
if (req.body && req.body.tweet) { 


tweets.push (req.body .tweet) 


if(acceptsHtml (req.headers['accept'])) { 
res.redirect('/', 302) 
} else { 
res.send({status:"ok", message:"Tweet received"}) 
} 
} else { 


// 没有 tweet? 
res.send({status:"nok", message:'"No tweet received"}) 


} 
}) 
大 部 分 代码 和 例 2-10 中 相同 ， 但 增加 了 头 信息 中 accept 字段 是 否 包含 text /html 
的 检查 。 如 果 包 含 ， 我 们 就 调用 res .redirect 指令 告诉 浏览 器 重 定向 到 / 去 。 需 
要 返回 302 状态 码 ， 因 为 这 不 是 永久 性 地 改变 路 径 ， 我 们 想 让 剖 览 器 每 次 发 送 tweet 
时 还 是 以 /send 为 入 口 。 
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编写 健壮 的 Node 程 序 





要 想 利用 好 服务 端的 JavaScript 环境 ， 关 键 是 要 理解 Node.js 和 JavaScript 设计 决策 
背后 的 一 些 核心 理念 。 理 解 设计 决策 及 其 利 刺 得 失 能 帮助 你 更 轻松 地 写 出 好 代码 并 
做 好 系统 架构 ， 还 能 帮助 你 向 别人 解释 清楚 ， 为 什么 Node.js 和 他 们 平时 用 的 系统 
不 一 样 ， 其 性 能 是 如 何 得 到 提高 的 。 工 程 师 都 不 喜欢 自己 的 系统 中 有 不 清楚 的 地 方 ， 
他 们 不 接受 用 “魔力 ”来 和 党 统 地 解释 一 切 ， 而 需要 清楚 地 知道 一 个 特定 的 架构 为 何 
能 带 来 益处 ， 以 及 在 什么 样 的 情景 下 能 带 来 益处 。 


本 章 将 涵盖 代码 风格 、 设 计 模 式 、 产 品 诀窍 等 ， 而 这 些 都 是 写 出 既 优 秀 又 健壮 的 
Node 代码 所 需要 了 解 的 。 


3.1 事件 循环 


Node 的 一 个 核心 功能 就 是 事件 衢 环 ， 这 一 概念 也 多 用 于 JavaScript 底层 行为 及 许多 交 
互 系统 中 。 在 许多 语言 中 ， 事 件 模型 是 在 外 层 的 ， 但 JavaScript 事件 一 直 是 其 语言 的 
核心 模块 ， 这 是 因为 JavaScript 在 很 多 情景 下 都 需要 处 理 与 用 户 交 互 的 事件 。 用 过 现 
代 网 页 浏览 器 的 人 都 习惯 在 网 页 上 通过 onclick、onmouseover 等 事件 来 进行 操作 。 
这 些 事件 是 那么 常见 ， 我 们 在 开发 网 页 交互 的 时 候 甚至 会 忘记 它们 的 存在 ， 但 在 语言 
内 部 支持 事件 模型 是 何等 强大 的 功能 ! 在 服务 器 端 ， 没 有 了 网 页 DOM 对 应 的 那些 有 
限 的 用 户 驱 动 型 交互 事件 ， 而 是 在 服务 器 程序 上 对 应 发 生 的 各 种 不 同 的 事件 ， 比 如 
HTTP 服务 器 模块 在 用 户 发 送 请 求 给 Web 服务 器 时 会 触发 request 事件 。 


JavaScript 利用 事件 循环 来 合理 地 处 理 系统 各 部 分 的 请 求 。 在 计算 领域 ， 人 们 可 以 
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用 若干 不 同 的 方法 来 处 理 实 时 或 并 行 运 算 ， 但 大 多 数 方法 都 太 过 复杂 ， 甚 至 让 人 头 
疼 。JavaScript 采用 了 很 简易 的 方法 ， 使 得 处 理 过 程 更 容易 理解 ， 但 是 它 需 要 有 一 
些 限 制 条 件 。 当 你 把 握 了 事件 循环 的 工作 原理 后 ， 就 能 充分 地 扬长 避 短 了 。 


Node 采用 的 方式 是 ， 所 有 的 IO 事件 都 应 该 是 非 阻塞 的 〈 稍 后 会 解释 原因 )。 这 意 
味 着 需要 让 程序 暂停 操作 的 HTTP 请 求 、 数 据 库 查询 、 文 件 读 写 ， 以 及 其 他 事情 在 
数据 返回 之 前 并 不 暂停 执行 。 这 些 事件 都 将 独立 运行 ， 然 后 在 数据 准备 好 以 后 触发 
一 个 事件 。 也 就 是 说 ， 用 Node.js 编程 会 用 到 很 多 回调 函数 ， 来 处 理 各 种 WO。 回 调 
函数 往往 以 级 联 的 方式 舱 在 其 他 回调 函数 中 ， 这 与 浏览 器 编程 有 所 不 同 。 除 了 用 顺 
序 的 方式 设置 好 启动 项 外 ， 大 部 分 代码 都 是 在 处 理 回 调 函 数 。 


针对 这 种 少见 的 编程 风格 ,我 们 需要 寻找 适合 服务 器 编程 的 处 理 模式 。 先 从 事件 循 
环 开始 吧 。 我 们 认为 大 部 分 人 直觉 上 是 理解 事件 驱动 编程 的 ， 因 为 这 和 日 常生 活 很 
像 。 假 设 你 在 烧 饭 ， 正 在 切 青 椒 的 时 候 锅 里 的 东西 开始 沸 溢 了 (图 3-1) ， 你 会 暂停 
切 菜 ， 把 炉 火 关 小 。 你 不 会 在 切 青椒 的 同时 把 炉 火 关 小 ， 而 是 会 采用 更 加 安全 的 方 
式 ， 通 过 快速 切换 工作 对 象 来 达到 同样 的 目的 。 事 件 驱 动 编程 也 是 同样 的 道理 。 通 
过 让 程序 员 一 次 只 能 为 一 个 回调 函数 编写 处 理 代 码 ， 可 以 让 代码 可 读 性 更 强 ， 而 且 
能 够 快速 地 处 理 多 个 任务 。 





























3-1: 事件 驱动 的 人 们 


在 日 常生 活 中 ， 我 们 习惯 于 用 各 种 内 部 回调 的 方式 来 处 理 遇 到 的 事件 。 和 JavaScript 
类 似 ， 我 们 一 次 只 能 处 理 一 件 事情 。 好 吧 ， 我 知道 你 可 以 同时 揉 肚子 和 拍 脑袋 ， 并 
且 能 两 样 都 干 得 不 错 ， 但 当 你 想 同时 做 一 些 重要 的 事情 时 ， 很 快 就 会 出 差错 的 。 这 
点 也 和 JavaScript 很 像 ， 能 让 事件 来 驱动 操作 很 棒 ， 但 它 只 能 以 “单线 程 ”的 方式 
运行 ， 即 同一 时 间 只 能 处 理 一 件 事情 。 


单线 程 的 概念 非常 重要 。 常 有 人 批评 Node.js 缺少 并 发 ， 也 就 是 它 没有 利用 机 器 上 
的 所 有 CPU 来 运行 JavaScript。 但 是 ， 同 时 在 多 个 CPU 上 运行 程序 也 有 它 的 问题 ， 
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是 需要 协调 多 个 执行 线程 的 。 要 让 多 个 CPU 有 效 地 拆 分 任务 ， 它 们 之 间 需 要 不 停 地 
交换 信息 ， 比 如 当前 执行 状态 ， 以 及 各 自 完 成 了 哪些 工作 。 虽 然 这 不 是 不 可 能 ， 但 
这 么 复杂 的 模型 给 程序 员 和 系统 带 来 了 很 大 的 工作 量 。JavaScript 的 方式 很 简单 : 同 
一 时 刻 只 有 一 件 事情 在 操作 。Node 做 的 每 一 件 事情 都 是 非 阻塞 的 ， 所 以 事件 触发 与 
Node 对 其 操作 的 时 间 间 隔 是 很 短 的 ， 因 为 Node 不 需要 等 待 如 磁盘 IO 这 样 的 操作 。 


再 举 个 邮递 员 投递 的 例子 ， 帮 助 你 理解 事件 人 循环。 邮递 员 的 每 封 信 都 是 一 个 事件 ， 
他 有 一 堆 事 件 等 着 要 按 顺序 处 理 ， 每 封 信 (事件 ) 都 要 走 到 相应 的 路 径 进行 投递 
(图 3-2)。 路 径 就 是 对 此 事件 的 回调 函数 (通常 不 止 一 条 路 径 )。 可 怜 的 是 ， 我 们 的 
邮递 员 只 有 一 双 腿 ， 每 次 只 能 走 其 中 一 条 路 径 。 









































图 3-2: 事件 驱动 的 邮递 员 


偶尔 ， 当 邮递 员 在 路 上 行走 时 ， 有 人 会 给 他 另外 一 封 信件 ， 这 就 像 是 投递 途中 的 回 
调 函 数 。 这 种 情况 下 ， 邮 递 员 会 马上 去 派送 新 的 信件 (因为 路 人 不 去 邮局 而 是 直接 
交 给 他 的 信件 ， 一 定 是 十 万 火 急 的 ) 。 此 时 邮递 员 会 立刻 切换 到 新 的 路 径 去 投递 新 邮 
件 ， 完 成 后 ， 再 回 到 之 前 的 路 径 上 继续 工作 。 


让 我 们 从 简单 情形 入 手 ， 对 比 一 下 邮递 员 的 行为 和 一 般 程 序 的 做 法 。 假 设 我 们 的 
Web 服务 器 (HTTP) 被 请 求 要 从 数据 库 中 读 取 一 些 数据 ， 然 后 返回 给 用 户 。 在 这 
种 情况 下 ， 我 们 只 要 处 理 很 少 的 事件 。 首 先 ， 用 户 的 请 求 多 是 要 Web 服务 器 返回 一 
个 网 页 。 处 理 这 个 初始 请 求 的 回调 函数 (我们 称 之 为 回调 函数 A) 会 先 从 请 求 的 对 
象 中 确定 它 要 从 数据 库 读 取 什么 内 容 ， 然 后 向 数据 库 发 起 具体 的 请 求 ， 并 传 入 一 个 
函数 (回调 函数 B) 供 请 求 完成 时 使 用 。 处 理 完 请 求 后 ， 回 调 函 数 A 结束 并 返回 。 
当 数 据 库 找到 需要 的 内 容 后 ， 再 触发 相应 事件 。 事 件 循 环 队列 则 调用 回调 函数 B， 
让 它 把 数据 发 送 给 用 户 。 
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这 似乎 非常 直观 。 这 里 需要 特别 注意 的 是 代码 “隔断 ”的 地 方 ， 这 也 是 过 程式 的 程 
序 不 会 遇 到 的 情况 。 因 为 Node.js 是 一 个 非 阻 塞 的 系统 ， 所 以 当 调 用 需要 阻塞 等 待 
的 数据 库 函 数 时 ， 我 们 会 采用 回调 函数 替代 闲置 等 待 。 这 就 是 说 ， 由 另外 一 些 国 数 
来 接管 这 个 请 求 ， 并 在 数据 准备 好 返回 时 把 它 处 理 掉 。 所 以 我 们 需要 确认 回调 函数 
所 要 用 到 的 数据 能 够 有 办 法 取得 。JavaScript 编程 通常 是 利用 闭 包 来 实现 这 个 功能 
的 。 稍 后 ， 我 们 会 进一步 介绍 闭 包 。 





























为 什么 Node 更 加 高 效 呢 ? 想象 一 下 在 一 家 快餐 店 点 餐 。 你 在 柜台 排队 时 ， 服 务 员 
有 两 种 方法 来 处 理 你 的 点 单 ， 一 种 是 事件 驱动 的 ， 另 一 种 则 不 是 。 我 们 先 采 用 PHP 
等 许多 Web 平台 所 使 用 的 方法 。 你 点 餐 时 ， 服 务 员 先 招待 你 ， 待 你 点 完 后 才 服 务 
下 一 个 客人 。 他 输入 完 你 的 单子 后 ， 可 以 做 以 下 几 件 事情 : 收 款 、 为 你 倒 饮料 等 。 
但 是 ， 服 务 员 还 不 知道 要 等 多 和 久 厨 房 才能 够 把 你 要 的 汉 保 做 好 〈 如 果 你 们 中 有 一 人 
是 素食 主义 者 ， 可 能 还 要 等 更 长 时 间 )。 在 传统 的 Web 服务 框架 下 ， 每 个 服务 程序 
(线程 ) 每 次 只 能 服务 一 个 请 求 。 唯 一 增加 处 理 能 力 的 方法 就 是 加 入 更 多 的 线程 。 很 
显然 这 样 的 做 法 并 不 是 那么 地 高 效 ， 服 务 员 在 等 待 厨房 做 菜 时 浪费 了 很 多 时 间 。 


显然 ， 现实 生活 中 的 餐馆 使 用 的 是 更 加 高 效 的 模式 。 你 点 完 菜 后 ， 服 务 员 会 给 你 一 
个 号 码 ， 在 莱 做 好 时 通知 你 ， 你 可 以 称 这 个 为 回调 号 码 。Node 也 是 这 样 工作 的 。 当 
IO 一 类 的 费时 操作 开始 时 ，Node 会 给 它们 一 个 回调 引用 ， 然 后 继续 处 理 其 他 已 
经 就 绪 的 工作 。 比 如 说 服务 员 可 以 服务 下 一 个 客人 (对 Node 来 说 ， 则 是 下 一 个 事 
件 )。 需 要 重点 关注 的 是 ， 与 邮递 员 的 例子 一 样 ， 餐 厅 服 务 员 也 绝 不 会 在 同一 时 间 服 
务 两 个 客人 。 当 呼叫 某 位 客人 来 取 食 物 的 时 候 ， 他 们 不 会 处 理 新 客人 的 需求 ， 反 之 
也 是 一 样 。 通 过 事件 驱动 的 运作 方式 ， 服 务 员 能 够 最 大 程度 地 提高 产 出 。 


下 面 这 个 例子 展示 了 在 什么 样 的 情况 下 使 用 Node 最 合适 ， 以 及 什么 情况 下 它 不 合 
适 。 在 一 些小 餐馆 ， 厨 师 和 服务 员 是 同一 个 人 ， 这 种 情况 下 采用 事件 驱动 并 不 能 提 
高 效率 ， 因 为 所 有 的 工作 都 由 同一 个 人 完成 ， 事 件 驱 动 的 架构 并 不 能 增加 价值 。 如 
果 服 务 器 的 全 部 (或 大 部 分 ) 工作 是 进行 运算 ，Node 并 非 最 理想 的 模型 。 


同时 ， 我 们 也 能 发 现 这 个 架构 在 什么 时 候 合适 。 假 设 在 餐馆 中 有 两 名 服务 员 和 四 位 
客人 (图 3-3)。 如 果 服 务 员 一 次 只 服务 一 位 客人 ， 那 么 头 两 位 客人 可 以 最 快 地 拿 到 
食物 ， 而 第 三 和 第 四 位 客人 的 体验 会 很 糟糕 。 前 两 位 客人 之 所 以 能 够 快速 地 获得 食 
品 ， 是 因为 服务 员 在 全 力 满 足 他 们 的 要 求 ， 这 占用 了 另外 两 位 客人 的 时 间 。 在 事件 
驱动 模型 下 ， 头 两 位 客人 可 能 需要 稍微 等 待 一 下 才能 拿 到 食物 ， 因 为 服务 员 需 要 先 
处 理 一 下 后 面 两 位 客人 的 点 单 ， 但 系统 的 平均 等 待 时 间 (延迟 ) 将 大 大 降低 。 









































36 | 第 3 章 





图 3-3: 快餐 ,快捷 代码 


现在 我 们 看 看 另外 一 个 例子 。 我 们 给 事件 循环 模式 的 邮递 员 一 封 信 去 投递 ， 但 投递 
这 封 信 需 要 经 过 一 扇 门 。 他 到 达 了 目的 地 ， 而 门 却 关 闭 着 ， 所 以 他 只 能 等 待 并 不 停 
地 尝试 进入 。 他 等 待 门 打 开 就 像 进入 了 死 循 环 模式 (图 3-4) 。 如 果 在 信件 队列 里 有 
另外 一 封 信 能 够 通知 某 和 人 来 打开 门 ， 让 邮递 员 进 去 ， 这 不 就 解决 问题 了 吗 ? 不 幸 的 
是 ， 邮 递 员 正 在 无 休止 地 等 待 打开 门 ， 无 法 抽身 去 投递 那 封 信 ， 这 是 因为 打开 门 的 
事件 是 在 当前 回调 事件 的 外 部 。 如 果 在 回调 函数 内 发 起 事件 ， 我 们 知道 邮递 员 会 优 
先 把 这 封 信 给 投递 掉 ， 但 是 当 事 件 是 在 当前 执行 代码 的 外 部 发 生 时 ， 它 必须 等 待 正 
在 执行 的 代码 完成 之 后 才 会 被 调用 。 





开门 





循环 队列 











图 3-4: 被 堵塞 的 事件 队列 
如 例 3-1 所 示 ，Node.js (或 浏览 器 ) 创建 的 事件 永远 不 会 跳出 。 
例 3-1 堵塞 事件 循环 的 代码 


EE 
ee 


require('events') .EventEmitter; 
new EE(); 
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die = false; 


ee.on('die', function() { 
die = true; 


二 


setTimeout (function() { 
ee.emit ('die'); 
}, 100); 


while(!die) { 


} 

console.log('done'); 
在 上 面 的 例子 中 ，console.1og 永远 不 会 被 调用 ， 因 为 while 循环 不 会 让 Node 有 
机 会 触发 timeout 回调 函数 并 且 发 起 aie 事件 。 虽 然 我 们 不 太 会 写 这 样 一 个 依赖 外 
部 条 件 作 为 跳出 判断 的 循环 体 ， 但 它 展 示 了 Node.js 同时 只 处 理 一 件 事 的 本 质 ， 任 
何 一 点 缺陷 都 可 能 导致 整个 系统 混乱 。 这 也 是 事件 驱动 编程 的 核心 模块 是 非 阻 塞 I/ 
0 的 原因 。 


我 们 再 做 一 下 算术 。 当 CPU 进行 一 次 运算 的 时 候 (不 是 一 行 JavaScript 代码 ， 而 是 
单一 的 机 器 码 运算 ) 大 概 需要 1/3 纳 秒 (ns)。 一 个 3Ghz 的 处 理 器 每 秒 运 行 3x 109 
个 指令 ， 所 以 每 个 指令 花费 10-9/3 秒 。 主 流 的 CPU 内 部 有 两 种 内 存 ，L1 和 1L2 
cache， 访 问 速度 大 概 为 2~5 纳 秒 。 如 果 我 们 从 内 存 (RAM) 读 取 数 ， 需 要 花费 大 
概 80 纳 秒 ， 比 运行 指令 要 慢 两 个 数量 级 。 但 这 些 操作 都 是 在 同一 个 场景 下 的 。 从 更 
慢 的 IO 途径 中 读 取 内 容 则 太 粳 糕 了 。 如 果 把 从 RAM 中 读 取 数据 比 作 一 只 猫 的 重 
量 ， 那 么 从 硬盘 上 读数 据 就 比 得 上 一 头 鲜 了， 而 从 网 络 上 等 数据 就 像 是 100 头 鲸 的 
重量 。 假 设 拿 运 行 var foo = "bar" 与 一 个 数据 库 查询 对 比 ， 简 直 就 是 一 只 猫 和 
100 头 鲸 比重 量 。 阻 塞 式 IO 并 非 真 的 在 事件 循环 的 邮递 员 前 面 放 了 一 扇 真 实 的 门 ， 
它 只 是 把 邮递 员 送 到 遥远 的 非洲 大 陆 后 再 回来 投递 信件 。 


有 了 事件 循环 的 基本 认识 后 ， 我 们 看 看 常用 的 Node.js 代码 是 如 何 创建 HTTP 服务 
器 的 ( 例 3-2)。 









































例 3-2 基本 的 HTTP 服务 器 


Var http = require('http'); 

http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 

站 listen(8124, "127;0.0,.1"); 

console.log('Server running at http://127.0.0.1:8124/'); 


这 是 Node.js 网 站 上 展示 的 最 简单 例子 (但 稍 后 我 们 会 说 明 这 并 非 编 码 的 理想 方 
式 )。 在 例子 里 ， 通 过 调用 http 库 的 一 个 工厂 方法 来 创建 HTTP 服务 器 。 工 厂 方法 
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在 创建 新 的 HTTP 服务 器 的 同时 ， 为 request 事件 绑 定 了 一 个 回调 函数 ， 后 者 作 
为 createServer 的 一 个 参数 传递 进去 。 当 代码 运行 的 时 候 会 发 生 什 么 有 趣 的 事情 
呢 ? Node.js 运行 的 第 一 件 事情 是 把 例子 中 的 代码 从 头 到 尾 运行 一 遍 ， 这 可 以 认为 
是 Node 编程 的 “设置 ”阶段 。 因 为 我 们 绑 定 了 一 些 事件 监听 器 ， 所 以 Node.js 不 会 
退出 ， 而 是 等 待 这 些 事件 被 触发 。 如 果 我 们 没有 绑 定 任何 事件 ，Node.js 在 运行 完 代 
码 后 就 会 立刻 退出 。 


那么 当 服 务 器 接收 到 一 个 HTTP 请 求 时 会 进行 什么 处 理 呢 ? Node.js 会 发 起 
request 事件 ， 因 为 该 事件 有 对 应 的 回调 函数 绑 定 在 上 面 ， 回 调 函 数 会 被 依次 调 
用 。 在 本 例 中 ， 只 有 一 个 回调 函数 ， 那 就 是 在 调用 createserver 时 作为 参数 传 入 
的 匿名 函数 。 我 们 假设 在 服务 器 启动 以 后 来 了 第 一 个 请 求 ， 因 为 这 个 时 候 没 有 任何 
其 他 代码 在 运行 ， 所 以 这 个 request 事件 被 马上 处 理 并 调用 回调 函数 。 这 是 个 极为 
简单 的 回调 过 程 ， 所 以 运行 飞快 。 


假设 我 们 的 网 站 变 得 非常 受 欢 迎 ， 同 时 有 很 多 的 请 求 进来 了 。 为 了 方便 讨论 ， 假 设 
回调 函数 需要 执行 1 秒 钟 。 在 第 一 个 请 求 后 紧 跟 着 又 来 了 第 二 个 请 求 ， 那 么 第 二 个 
请 求 将 不 会 在 这 1 秒 内 被 处 理 。 显 然 1 秒 钟 其 实 是 很 长 的 时 间 了 。 让 我 们 看 看 真实 
应 用 情景 ， 事 件 循环 堵塞 的 问题 会 严重 地 破坏 用 户 体验 。HTTP 服务 器 实际 上 是 由 
操作 系统 内 核 处 理 与 客户 端的 TCP 连接 的 ， 所 以 尽管 不 会 恶化 到 拒绝 新 连接 的 境 
地 ， 但 仍然 会 有 这 些 链接 不 被 处 理 的 危险 。 为 了 处 理 这 些 问题 ， 我 们 希望 尽量 保持 
Node.js 的 事件 驱动 和 非 阻塞 的 特性 。 同 样 的 方式 ， 让 费时 的 VO 事件 用 回调 的 方法 
来 通知 Nodejs， 只 有 数据 已 经 准备 好 了 ， 才 可 以 进行 下 一 步 操作 。Node.js 程序 本 
身 需要 把 每 一 个 回调 函数 都 写 得 运行 迅速 ， 防 止 把 事件 循环 给 堵塞 住 。 


这 意味 着 你 在 编写 Node.js 服务 器 程序 的 时 候 需 要 遵循 以 下 两 个 策略 。 


。 在 设置 完成 以 后 ， 所 有 的 操作 都 是 事件 驱动 的 。 

。 如 果 Node.js 需要 长 时 间 处 理 数 据 ， 就 需要 考虑 把 它 分 配给 web worker 去 处 理 。 
事件 驱动 方法 配合 事件 循环 工作 起 来 非常 高 效 〈 正 如 它 的 名 字 所 暗示 的 ) ， 但 编写 容 
易 阅 读 和 理解 的 事件 驱动 代码 也 同样 重要 。 在 前 面 的 例子 里 ， 我 们 用 匿名 函数 作为 
事件 回调 ， 这 会 导致 几 点 不 便 。 首 先 ， 我们 无 法 控制 代码 在 哪里 使 用 。 匿 名 函数 只 
有 在 被 使 用 的 地 方才 存活 ， 而 不 是 在 绑 定 事件 回调 时 存活 ， 这 会 影响 调试 。 如 果 所 
有 东西 都 是 匿名 事件 ， 当 异常 发 生 时 ， 就 很 难 分 辨 出 是 哪个 回调 函数 导致 了 问题 。 


3.2 模式 


事件 驱动 编程 和 过 程式 编程 是 不 一 样 的 ， 最 简单 的 学 习 方式 是 参照 前 人 实践 过 的 常 
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用 模式 。 这 正 是 本 市 的 目的 。 


在 介绍 模式 之 前 ， 我 们 先 看 一 下 各 种 编程 风格 背后 发 生 了 哪些 事情 ， 以 便 确 定 讨论 
模式 的 语 境 。 本 节 主 要 探讨 IO 问题 ， 正 如 3.1 节 所 讨论 的 那样 ， 事件 驱动 编程 主 
要 是 为 了 解决 IO 问题 。 当 处 理 不 需要 IO 操作 的 内 存 数据 时 ，Node 也 可 以 使 用 完 
全 过 程式 结构 。 





MO 问题 
我 们 先 从 高 效 系统 需要 用 到 的 1/O 类 型 开始 入 手 ， 这 些 是 所 用 到 的 模式 的 基础 。 


首先 要 查看 的 是 串 行 与 并 行 VO 间 的 明显 区 别 。 串 行 很 简单 ， 即 先进 行 一 个 IO 操 
作 ， 完 成 以 后 ， 再 做 下 一 个 ;并行 实现 起 来 比较 复杂 ， 但 也 不 难 理解 ， 即 同时 进行 
两 个 IO 操作 。 重 点 是 ， 在 串 行 任务 中 通常 完成 顺序 是 确定 的 ， 而 在 并 行 任务 中 任 
何 一 个 操作 先 完成 返回 都 是 有 可 能 的 。 


串 行 和 并 行 任务 混合 在 一 起 也 是 可 以 的 。 例 如 ， 两 组 并 行 请 求 可 以 串 行 执行 ， 即 先 
同时 执行 两 个 任务 ， 然 后 再 同时 执行 另外 两 个 任务 。 


在 Node 里 ， 我 们 假设 所 有 的 IO 都 有 无 限 长 的 延迟 ， 也 就 是 说 任何 IO 任务 都 可 能 
需要 花费 0 到 无 限 长 的 时 间 。 我 们 不 清楚 ， 也 无 法 假设 ， 这 些 任 务 会 执行 多 长 时 间 ， 
所 以 我 们 不 会 等 待 它们 执行 ， 而 是 使 用 占 位 器 (事件)， 它 会 在 WO 完成 时 触发 回调 
函数 。 因 为 我 们 假设 了 无 限 延 迟 条 件 ， 这 让 执行 并 行 任务 变 得 简单 。 你 只 需要 对 不 
同 的 VO 操作 进行 调用 ， 它 们 会 在 准备 好 数据 的 时 候 返 回 给 你 ， 但 是 次 序 是 无 法 预测 
的 。 按 顺序 的 串 行 请 求 可 以 用 艇 入 的 方法 ， 或 者 把 引用 回调 放 在 一 起 。 这 样 当 第 一 个 
回调 触发 时 ， 它 会 发 起 第 二 个 VO 请 求 ， 第 二 个 回调 则 局 动 第 三 个 ， 以 此 类 推 。 即 使 
所 有 的 请 求 都 是 匿 名 的 ， 而 且 不 会 堵塞 事件 循环 ， 它 们 还 是 会 以 串 行 顺 序 执行 。 这 种 
按 次 序 执行 的 模式 是 有 必要 的 ， 比 如 下 一 个 VO 操作 需要 依赖 第 一 个 IO 操作 的 结果 。 


到 目前 为 止 ， 我 们 有 两 种 方法 来 操作 IO: 按 顺序 的 串 行 请 求 ， 无 序 的 并 行 请 求 。 
有 序 的 并 行 请 求 也 是 一 种 有 用 的 模式 ， 比 如 当 我 们 允许 IO 操作 同时 发 出 请 求 ， 但 
又 需要 按 特定 的 次 序 来 处 理 结果 时 。 无 序 的 串 行 IO 操作 并 没有 什么 用 处 ， 所 以 我 
们 不 把 它 作为 一 种 模式 使 用 。 


1. 无 序 的 并 行 1O 


我 们 先 从 无 序 的 并 行 VO 开始 ( 例 3-3)， 因 为 这 是 在 Node 中 最 容易 实现 的 。 事 实 
上 ，Node 中 所 有 的 IO 操作 默认 都 是 无 序 并 行 的 ， 因 为 Node 的 所 有 LO 都 是 异步 
非 阻塞 的 。 我 们 操作 IO 时 ， 只 要 扔 出 请 求 然 后 等 待 结果 就 行 了 。 所 有 请 求 可 能 按 
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我 们 操作 的 顺序 执行 ， 也 可 能 不 是 。 我 们 指 的 无 序 ， 并 不 是 指 乱 序 ， 而 是 指 顺序 没 
有 保证 。 


例 3-3 ”Node 中 的 无 序 并 行 WO 


fs.readFile('foo.txt', 'utf8', function(err, data) { 
console.log(data); 

}; 

fs.readFile('bar.txt', 'utf8', functionl(err, data) { 
console.log(data); 


} 
简单 地 调用 LO 请 求 并 指定 回调 函数 就 会 创建 无 序 并 行 IO 操作 。 在 未 来 的 某 一 时 
刻 ， 所 有 的 这 些 回调 函数 都 会 被 触发 ,但 哪 一 个 先 被 触发 是 未 知 的 。 而 且 ， 如 果 某 
一 个 请 求 返回 了 错误 而 非 数据 ， 也 不 会 影响 其 他 请 求 。 


2. 顺序 串 行 VO 


在 这 个 模式 里 ， 我 们 希望 按 顺 序 执行 一 些 IO (无 限 延 时 ) 任务 。 每 一 个 任务 都 必 
须 在 上 一 个 任务 完成 后 才能 开始 。 在 Node 里 ， 这 意味 着 使 用 嵌 套 回调 ， 这 样 可 以 
在 每 个 任务 的 回调 函数 里 发 起 下 一 个 任务 ， 如 例 3-4 所 示 。 


例 3-4 租 入 回调 函数 来 完成 顺序 请 求 


server.on('request', function(req, res) { 
// 从 memcached 里 获取 session 信息 
memcached.getSession(req, function(session) { 
// 从 db 获取 信息 
db.get (session.user, function (userData) { 
// 其 他 web 服务 调用 
ws.get (req, function (wsData) { 
// 泻 染 页 面 
page = pageRender (req, session, userData, wsData); 
// 输出 响应 内 容 


res.write (page); 








虽然 伐 入 回调 函数 很 容易 创建 顺序 串 行 WO， 但 它 的 代码 看 起 来 很 像 “ 金 字 塔 ”'。 
这 样 的 代码 很 难 阅 读 和 理解 ， 也 难以 维护 。 比 如 ， 扫 一 眼 例 3-4 并 不 能 看 清楚 
memcached.getSession 请 求 完 成 后 发 起 db.get 请 求 ， 等 db.get 完成 后 又 发 起 
ws .get 请 求 ， 等 等 。 要 让 代码 可 读 又 不 会 破坏 顺序 串 行 模式 ， 有 几 种 方法 。 


第 一 ， 我 们 可 以 继续 用 内 联 函 数 声明 ， 但 要 给 它们 增加 名 字 (如 例 3-5)。 这 样 容易 
调试 ， 而 且 还 表明 了 该 回调 函数 的 目的 。 


注 1: 这 个 词 是 由 Tim Caswell 杜撰 的 。 
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例 3-5 回调 函数 中 的 命名 函数 


server.on('request', getMemCached (req, res) { 
memcached.getSession(req, getDbInfo(session) { 
db.get (session.user, getWsInfo(userData) { 
ws.get (req, render (wsData) { 
// 泻 染 页 面 
page = pageRender (req, session, userData, wsData); 
// 输出 响应 内 容 


res.write (page); 


另 一 种 方法 需要 改变 代码 风格 ， 用 提前 声明 的 函数 代替 匿名 函数 或 命名 函数 。 这 会 
把 金字 塔 拆 散 ， 改 为 按 执行 顺序 展示 ， 并 且 代 码 被 拆 分 成 更 加 可 控 的 小 块 (请 参考 
例 3-6)。 


例 3-6 用 声明 函数 把 代码 分 离 


var render = function(wsData) { 
page = pageRender (req, session, userData, wsData); 


var getWsInfo = function(userData) { 
ws.get (req, render); 


二 


var getDbInfo = function(session) { 
qdqb.get(session.user，dgetWsInfo) ; 


}; 


var getMemCached = function(req, res) { 
memcached.getSession(req, getDbInfo); 


}; 
例子 中 的 代码 并 不 能 真 的 工作 。 原 本 的 岁 套 代码 利用 闭 包 封装 了 一 些 变 量 ， 使 得 内 
嵌 函 数 能 够 访问 这 些 变量 。 所 以 ， 当 状态 不 需要 在 3 个 以 上 回调 函数 间 共 享 时 ， 声 
明 式 函数 比较 适合 。 如 果 下 一 个 函数 只 需要 从 上 一 个 回调 函数 中 获取 信息 ， 声 明 式 
国 数 就 能 很 好 地 工作 (特别 是 加 上 文档 的 话 )， 而 且 比 多 层 髓 套 函 数 可 读 性 更 好 。 


当然 ， 让 数据 在 函数 间 传 递 有 多 种 方法 。 大 多 数 情况 下 ， 我 们 还 是 采用 JavaScript 
语言 本 身 的 特性 。JavaScript 有 函数 作用 域 ， 意思 是 当 你 在 函数 内 部 定义 变量 时 ， 
这 个 变量 在 函数 内 本 地 可 见 。 但 是 ， 简 单 的 使 用 { 和 } 并 不 会 限制 一 个 变量 的 作用 
域 。 这 就 允许 我 们 在 内 艇 的 回调 函数 中 可 以 访问 外 部 回调 函数 内 定义 的 变量 ， 即 使 
外 部 函数 已 经 返回 并 关闭 了 也 依然 能 够 访问 。 当 和 岗 套 回调 函数 时 ， We 
有 之 前 回调 函数 中 的 变量 都 绑 定 到 最 新 定义 的 回调 函数 内 了 ， 这 也 让 许多 骨 套 变 
复杂 。 














我 们 依然 可 以 采用 展开 的 重 构 方法 ， 但 需要 创建 一 个 把 原始 请 求 都 包含 的 共享 作用 
域 ， 用 一 个 闭 包 把 所 有 的 回调 函数 都 包含 进去 。 这 样 ， 所 有 与 初始 请 求 相 关 的 回调 
函数 都 被 封装 起 来 ， 并 通过 闭 包 内 的 变量 共享 状态 ( 例 3-7)。 

例 3-7 在 回调 函数 中 封装 


server.on('request', function(req, res) { 

















var render = function(wsData) { 
page = pageRender (reqg, session, userData, wsData); 


var getWsIinfo = function(userData) { 
ws.get (req, render); 


过 


var getDbInfo = function(session) { 
db.get (session.user, getWsIinfo); 


二 


var getMemCached = function(req, res) { 
memcached.getSession(req, getDbInfo); 


}s 
} 


采用 这 一 做 法 ,不 但 代码 组 织 更 有 风 辑 性 ， 而 且 利 用 展开 的 方法 避免 了 多 层 舱 人 套 的 
困 绕 。 








其 他 创新 的 组 织 方式 也 是 存在 的 。 有 时 候 你 可 以 把 代码 重用 到 许多 函数 中 ， 此 时 就 
有 了 中 间 件 的 用 武之 地 了 。 中 间 件 有 许多 实现 方法 ，Node 中 最 流行 的 一 种 做 法 是 
Connect 框架 所 使 用 的 模块 ， 就 像 是 Ruby 世界 中 的 Rack 一 样 。 其 实现 背后 的 思想 
是 ， 在 传递 过 程 中 ， 不 单 把 状态 传递 过 去 ， 还 包括 了 跟 状 态 交 互 的 方法 。 


在 JavaScript 中 ， 对 象 是 以 引用 的 方式 传递 的 。 意 思 是 ， 当 你 调用 我 的 Function 
(someObject) 时 ， 对 someobject 的 任何 修改 ， 都 会 影响 你 当前 函数 作用 域 中 所 
有 对 someObject 的 引用 。 这 存在 着 潜在 风险 ,但 只 要 你 小 心 处 理 可 能 出 现 的 副 作 
用 ， 就 会 收获 巨大 的 能 力 。 副 作用 在 异步 代码 中 是 非常 危险 的 。 如 果 回 调 函 数 使 用 
的 对 象 被 别人 修改 了 ， 它 难以 确定 是 什么 时 候 被 修改 的 ， 因 为 运行 的 次 序 是 非 线 性 
的 。 如 果 你 对 参数 传递 进来 的 对 象 进行 修 改 的 话 ， 需 要 仔细 考虑 这 些 对 象 将 来 会 在 
什么 地 方 使 用 。 


简单 的 做 法 是 ， 用 某 个 东西 来 表示 状态 ， 然 后 把 它 在 所 有 需要 依赖 此 状态 的 函数 
间 传 递 。 这 就 需要 所 有 依赖 此 状态 的 国 数 通过 统一 的 接口 来 互相 传递 。 这 也 是 
Connect (以 及 Express) 中 间 件 的 形式 都 是 fucntion (req，res，next) 的 原因 。 
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关于 Connect/Express 中 间 件 的 详细 内 容 我 们 将 在 第 7 章 讨 论 。 


现在 ， 我 们 先 看 看 基本 思路 〈 例 3-8)。 当 在 函数 间 共 享 对 象 时 ， 调 用 堆栈 上 靠 前 的 
国 数 会 影响 这 些 对 象 的 状态 ， 并 传递 给 后 续 国 数 。 


例 3-8 在 函数 间 传 递 修改 后 的 内 容 


var AwesomeClass = function() { 
this.awesomeProp = 'awesome!' 
this.awesomeFunc = function(text) { 
console.log(text + ' is awesome!') 
} 
} 


Var awesomeObject = new AwesomeClass () 


function middleware (func) { 
oldFunc = func.awesomeFunc 
func.awesomeFunc = function(text) { 
text = text + ' really' 
oldFunc (text) 


} 
} 
function anotherMiddleware (func) { 
func.anotherProp = 'super duper' 
} 


function caller (input) { 
input .awesomeFunc (input .anotherProp) 


} 


middleware (awesomeObject) 
anotherMiddleware (awesomeObject) 
caller (awesomeObject) 


3.3 编写 产品 代码 

写 书 的 一 个 挑战 就 是 如 何 用 最 简单 的 语言 把 事情 讲 清楚 ， 但 这 又 与 展示 能 实际 部 署 
使 用 的 技术 和 功能 代码 背道而驰 。 虽 然 我 们 应 该 尽力 写 出 最 简洁 、 最 易 懂 的 代码 ， 
但 当 你 需要 做 些 事 情 让 代码 更 加 健壮 或 运行 更 快 时 ， 代 码 就 可 能 不 那么 简单 了 。 本 
节 指 导 你 加 固 即 将 部 署 的 代码 ， 也 便于 你 学 习 后 面 章节 的 内 容 。 我 们 将 介绍 如 何 编 
写成 熟 的 代码 ， 让 程序 能 够 长 久 地 运行 。 不 必 说 你 也 能 理解 ， 如 果 编 写 的 代码 很 健 
壮 ， 将 能 够 大 大 避免 以 后 的 维护 问题 。Node 单线 程 方面 的 取舍 使 其 倾向 于 变 得 脆 
弱 ， 本 节 要 讲 的 这 些 技术 则 能 够 帮助 减轻 这 个 风险 。 


部 署 生产 线 上 的 应 用 和 在 笔记 本 上 运行 测试 代码 是 不 一 样 的。 服务 器 有 许多 不 同 的 
资源 限制 ， 但 通常 拥有 比 开 发 机 器 更 多 的 资源 。 比 如 说 ， 与 笔记 本 或 台式 机 相 比 ， 
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前 端 服务 器 有 更 多 的 CPU、 更 大 的 RAM， 硬盘 空间 却 小 得 多 。Node 现在 有 一 些 
限制 ， 比 如 规定 了 最 大 的 JavaScript 堆栈 大 小 。 这 会 影响 你 的 部 署 方式 ， 因 为 在 使 
用 Node 的 易 编 程 、 单 线程 模型 来 部 署 时 ， 需 要 考虑 如 何 充分 地 利用 机 器 的 CPU 和 
内 存 。 





3.3.1 差错 处 理 

在 本 章 前 面 的 内 容 里 ， 我 们 介绍 了 Node 如 何 把 IO 操作 与 其 他 活动 分 离开 ， 差 错 
处 理 也 是 类 似 的 行为 。JavaScript 包含 了 try/catch 功能 ， 但 这 个 方法 只 有 当 错 误 发 
生 在 内 联 位 置 时 才 有 用 。 使 用 Node 的 非 阻 塞 WO 时 ， 你 给 函数 传递 了 一 个 回调 函 
数 ， 这 意味 着 回调 函数 被 事件 触发 调用 时 ， 是 不 在 try/catch 代码 块 中 的 。 我 们 需要 
为 异步 运行 情景 提供 差错 处 理 的 方法 。 看 看 例 3-9 的 代码 。 


例 3-9 党 试 在 回调 函数 中 捕获 错误 但 失败 了 


Var http = require('http') 














var opts = { 
host: 'sfnsdkfjdsnk.com', 
BAOrtEy 80; 
path: '/' 

} 

try { 


http.get (opts, function(res) { 
console.log('Will this get called?') 


} 


catch (e) { 
console.log('Will we catch an error?') 


} 


当 调 用 http.get () 时 ， 实 际会 发 生 什么 呢 ? 我 们 传人 了 一 些 参数 让 IO 进行 指定 
的 操作 ， 同 时 还 绑 定 了 回调 函数 。 当 IO 操作 完成 时 ， 回 调 函 数 会 被 调用 ,但 是 ， 
http.get () 在 设置 好 回调 函数 后 ， 就 直接 完成 并 继续 运行 下 去 了。 如果 在 GET 过 
程 中 发 生 错误 ， 将 不 会 被 try/catch 捕获 。 


IO 错误 的 隔离 在 Node 命令 行 解析 器 中 更 为 明显 ， 因 为 变量 返回 时 如 果 没 有 赋值 ， 
命令 行 会 打印 出 这 个 变量 。 我 们 可 以 看 到 http.get() 函数 的 返回 变量 是 新 创建 的 
http .ClientReduest 对 象 ， 这 就 表示 try/catch 完成 了 它 的 工作 ， 保 证 了 特定 的 
代码 返回 时 没有 发 生 错 误 。 但 是 ， 因 为 hostname 是 不 存在 的 ， 将 会 在 IO 请 求 时 出 
车 ， 也 就 是 回调 函数 不 会 成 功 调用 。try/catch 并 不 能 解决 此 问题 ， 因 为 错误 发 生 在 
这 个 JavaScript 代码 外 面 。 当 Node 遇 到 错误 想 要 报告 时 ， 我 们 早已 不 在 那个 栈 上 
了 。 我 们 已 经 在 处 理 另 一 个 事件 。 
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在 Node 中 ， 我 们 利用 error 事件 来 处 理 此 问题 。 这 是 一 个 特殊 的 事件 ， 当 错误 发 
生 时 它 就 会 触发 。 这 让 参与 IO 的 模块 触发 另外 一 个 事件 给 负责 处 理 错误 的 回调 函 
数 。error 事件 让 我 们 能 够 处 理 所 有 使 用 的 模块 中 可 能 出 现 的 问题 。 让 我 们 以 正确 
方式 写 一 下 前 面 的 例子 ， 如 例 3-10 所 示 。 


例 3-10 通过 error 事件 捕捉 IO 错误 


var http = require('http') 











var opts = { 
host: 'dskjvnfskcsjsdkcds.net', 
port: 80; 
path: '/' 


} 


var req = http.get (opts, function(res) { 
console.log('This will never get called') 


} 


req.on('error', function(e) { 

人 that pesky error trapped') 
通过 使 用 error 事件 ， 我 们 可 以 处 理 对 应 的 错误 (在 本 例 中 是 忽略 错误 )。 最 重要 
的 是 ， 我 们 的 程序 存活 下 来 了 。 就 像 JavaScript 的 try/catch 那样 ，error 事件 捕获 
了 所 有 类 型 的 异常 。 一 种 更 好 的 常用 异常 处 理 方法 是 ， 对 已 知 的 错误 条 件 设 置 好 检 
查 条 件 ， 并 尽 可 能 处 理 它们 。 此 外 ， 捕 获 剩 余 的 错误 ， 记 录 下 来 ， 并 保持 你 的 服务 
器 继续 运行 也 许 是 最 佳 的 方法 。 


3.3.2 ”使 用 多 处 理 器 

我 们 说 过 ，Node 是 单线 程 的 ， 这 意味 着 Node 只 能 利用 一 个 处 理 器 来 工作 。 但 是 ， 
多 数 服务 器 都 有 多 个 “多 核 ” 处 理 器 ， 一 个 多 核 处 理 器 就 包含 了 儿 个 处 理 器 。 有 两 
个 物理 CPU 插 槽 的 服务 器 可 能 有 24 个 逻辑 核 ， 也 就 是 说 操作 系统 看 起 来 有 24 个 处 
理 器 。 要 充分 发 挥 Node 的 作用 ， 需 要 把 这 些 处 理 器 都 利用 起 来 。 但 如 果 没 有 多 线 
程 ， 该 如 何 做 呢 ? 


Node 提供 了 一 个 cluster 模块 ， 可 以 把 任务 分 配给 子 进 程 ， 就 是 说 Node 把 当前 程 
序 复制 了 一 份 给 另 一 个 进程 (在 Windows 上 ， 它 其 实 是 另外 一 个 线程 )。 每 个 子 进 
程 有 些 特殊 的 能 力 ， 比 如 能 够 与 其 他 子 进程 共享 socket 连接 。 这 样 我 们 就 可 以 写 一 
个 Node 程序 ， 让 它 创 建 许多 其 他 Node 程序 ， 并 把 任务 分 配给 它们 。 


需要 重点 理解 的 是 ， 当 你 用 cluster 把 工作 共享 到 一 组 复制 的 Node 程序 时 ， 主 
进程 不 会 参与 到 每 个 具体 的 事务 中 。 主 进程 管理 所 有 的 子 进程 ， 但 当 子 进程 与 1/ 
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O 操作 交互 时 ， 它 们 是 直接 进行 操作 的 ， 不 需要 通过 主 进程 。 这 意味 着 ， 如 果 你 用 
cluster 来 创建 一 个 Web 服务 器 ， 请 求 将 不 会 通过 你 的 主 进程 ， 而 是 直接 连接 到 子 
进程 。 而 且 ， 调 度 这 些 请 求 并 不 会 导致 系统 出 现 瓶 颈 。 
通过 cluster API， 你 可 以 把 工作 分 配给 Node 进程 ， 并 分 布 在 服务 器 所 有 可 用 的 处 
理 器 上 ， 这 能 够 充分 利用 资源 。 让 我 们 看 一 个 简单 的 cluster 代码 例子 〈 例 3-11)。 
例 3-11 使 用 集群 来 分 发 任务 

var cluster = require('cluster'); 


Var http = require('http'); 
Var numCPUs = require('os') .cpus() .length; 





if (cluster.isMaster) { 
// 创建 工作 进程 
for (var i = 0; i < numCpUs; i++) { 
cluster.fork(); 


} 


cluster.on('death', function (worker) { 
console.log('worker ' + worker.pid + ' died'); 


} 

else { 

// 工作 进程 创建 http 服务 器 

http.Server (function(req, res) { 
res.writeHead (200); 
res.end("hello world\n"); 

}) .listen(8000); 


} 
在 例子 中 ， 我 们 使 用 了 Node 的 一 些 核心 模块 来 把 工作 平均 分 配 到 所 有 可 用 的 CPU 
上 ， 这 些 模块 为 : cluster 模块 、http 模块 和 os 模块 。 从 os 模块 中 ， 我 们 可 以 
轻松 得 到 系统 CPU 的 数量 。 


cluster 工作 的 原理 是 每 一 个 Node 进程 要 么 是 主 进程 ， 要 么 成 为 工作 进程 。 当 
一 个 主 进程 调用 cluster.fork() 方法 时 ， 它 会 创建 与 主 进程 一 模 一 样 的 子 进程 ， 
除了 两 个 让 每 个 进程 可 以 检查 自己 是 父 / 子 进程 的 属性 以 外 。 在 主 进程 中 (Node 
运行 时 直接 调用 的 那个 脚本 )，cluster.isMaster 会 返回 true， 而 cluster. 
isWorker 会 返回 false。 而 在 子 进 程 ，cluster.isMaster 返回 false， 且 


i 








cluster.isWorker 返回 true。 


例子 中 的 主 脚 本 为 每 个 CPU 创建 了 一 个 工作 进程 。 每 个 子 进程 创建 了 一 个 HTTP 服 
务 器 ， 这 是 cluster 另 一 个 独特 的 地 方 。 在 使 用 cluster 的 地 方 使 用 listen () 
监听 一 个 socket 的 时 候 ， 多 个 进程 可 以 同时 监听 同一 个 socket。 如 果 通 过 调用 node 
myscript.js 的 方法 启动 多 个 Node 进程 ， 会 导致 出 错 ， 因 为 第 二 个 进程 在 启动 时 





编写 健壮 的 Node 程 序 | 47 


会 抛 出 EADDRINUSE 的 异常 。cluster 提供 了 跨 平台 时 让 多 个 进程 共享 socket 的 方 
法 。 即 使 多 个 子 进 程 在 共享 一 个 端口 上 的 连接 ， 其 中 一 个 堵塞 了 ， 也 不 会 影响 其 他 
工作 进程 的 新 连接 。 


除了 共享 socket 外 ， 我 们 还 能 用 cluster 做 更 多 事情 ， 为 它 是 基于 chila 
process 模块 的 。 这 个 模块 会 提供 一 系列 属性 ， 其 中 最 有 用 的 一 些 可 以 检查 子 进程 
健康 状态 。 在 上 面 的 例子 中 ， 当 子 进程 死亡 时 ， 主 进程 会 用 console.1og() 输出 
死亡 提醒 。 例 3-12 中 提供 了 一 个 更 实用 的 例子 ， 它 会 调用 cluster.fork() 来 创 
建 一 个 新 的 子 进程 。 


例 3-12 出现 死亡 进程 后 重新 开启 新 的 进程 


if (cluster.isMaster) { 
// 创建 工作 进程 
for (var i=0; i<numCpUs; i++) { 
Cluster.,fork!(}).; 


} 























cluster.on('death', function (worker) { 
console.log('worker ' + worker.pid + ' died'); 
cluster.fork!(}).; 
}) ; 
} 
这 个 简单 的 改造 让 主 进程 会 不 停 地 把 死 掉 的 进程 重启 ， 从 而 保证 所 有 的 CPU 都 有 我 
们 的 服务 器 在 运行 。 然 而 ， 这 只 是 对 运行 状态 的 基本 检查 ， 我 们 还 能 用 更 多 花哨 的 
技巧 。 因 为 工作 进程 可 以 传 消息 给 主 进程 ， 所 以 可 以 让 每 个 工作 进程 报告 自己 的 状 
态 ， 如 内 存 使 用 量 。 这 让 主 进程 可 以 觉察 哪些 工作 进程 变 得 不 稳定 ， 确 认 哪 些 工 作 
进程 没有 冻结 ， 或 者 被 长 时 间 运 行 的 事件 堵塞 〈( 例 3-13 ) 。 


例 3-13 通过 消息 传递 来 监控 工作 进程 状态 


var cluster = tequire(''clIustez') ; 
var http = require('http'); 
Var numCpPUs = require('os') .cpus() .length; 
var rssWarn = (12 * 1024 * 1024) 
,， heapWarn = (10 * 1024 * 1024) 


if (cluster.isMaster) { 
for(var i=0; i<numCpUs; i++) { 
Var worker = cluster.fork(); 
worker.on('message', function(m) { 
if (m.memory) { 
if(m.memory.rss > rssWarn) { 
console.log('Worker ' + m.process + ' using too much memory.') 





}) 

} 

} else { 

// 服务 器 

http.Server (function(req,res) { 
res.writeHead (200); 
res.end('hello world\n') 

}) .listen(8000) 

// 每 秒 报告 一 次 状态 

setIinterval (function report (){ 
process.send({memory: process.memoryUsage(), process: process.pid}); 

}, 1000) 


} 
在 这 个 例子 里 ,工作 进程 报告 自己 的 内 存 使 用 量 ， 当 子 进程 使 用 了 过 多 内 存 时 ， 主 
进程 会 发 送 一 条 警告 到 日 志 中 去 。 这 是 运 维 团队 常用 的 检测 系统 健康 状态 的 功能 。 
这 让 Node 主 进程 有 控制 的 能 力 ， 也 带 来 了 好 处 。 这 个 消息 传递 的 接口 也 允许 主 进 
程 把 消息 发 回 给 工作 进程 ， 这 意味 着 你 可 以 把 主 进程 当成 工作 进程 的 一 个 轻 量 级 控 
制 接口 。 


我 们 还 能 用 消息 传递 做 更 多 的 事情 ， 而 这 些 事情 无 法 在 Node 之 外 实现 。 因 为 Node 
依赖 事件 循环 来 工作 ， 所 以 有 个 风险 是 其 中 一 个 事件 回调 函数 运行 了 很 长 的 时 间 ， 
这 会 导致 该 进程 的 其 他 用 户 需要 等 待 很 长 时 间 才 能 得 到 服务 。 主 进程 与 每 个 工作 进 
程 有 一 个 连接 ， 所 以 我 们 可 以 告诉 它 定 时 发 送 “all OK” 消 息 ， 这 样 我 们 就 能 够 验 
证 事件 循环 在 以 合适 的 速度 周转 着 ， 并 没有 被 某 个 回调 函数 堵塞 。 可 悲 的 是 ， 即 使 
识别 了 一 个 长 时 间 运 行 的 回调 函数 ， 我 们 也 无 法 主动 关闭 它 。 因 为 我 们 发 送 给 该 进 
程 的 任何 通知 都 会 加 到 事件 队列 里 ， 所 以 它 需 要 等 待 已 经 在 长 时 间 运 行 的 回调 函数 
结束 后 才 会 被 处 理 。 因 此 ， 虽 然 我 们 能 够 让 主 进程 识别 僵尸 进程 ， 但 唯一 的 补救 方 
法 就 是 杀 掉 工作 进程 ， 而 这 会 丢失 它 正在 执行 的 工作 。 

做 些 准 备 工作 就 能 让 你 有 能 力 杀 掉 某 个 威胁 到 系统 资源 的 工作 进程 ， 如 例 3-14 
所 示 。 

例 3-14 杀 死 僵尸 进程 


Var cluster = require('cluster'); 
Var http = require('http'); 























Var numCPUs = require('os') .cpus() .length; 
Var rssWarn = (50 * 1024 * 1024) 

, heapWarn = (50 * 1024 * 1024) 
var workers = {} 


if(cluster.isMaster) { 
for(var i=0; i<numCPpUs; i++) { 
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createWorker () 


} 


setInterval (function() { 
Var time = new Date() .getTime () 
for(pid in workers) { 
if (workers.hasOwnpProperty (pid) && 
workers [pid] .lastCb + 5000 < time) { 


console.log('Long running worker ' + pid + '' 
workers [pid] .worker .kill () 

delete workers [pid] 

createWorker () 


} 
} 


}, 1000) 
} else { 
// 服务 器 


http.Server (function(req,res) { 


// 打 乱 200 个 请 求 中 的 1 个 


if (Math.floor(Math.random() * 200) === 4) { 
console.log('Stopped ' + process.pid + ' from 
while(true) { continue } 

} 


res.writeHead (200)，; 


killed') 


ever finishing') 


res.end('hello world from ' + process.pid + '\n') 


}) .listen(8000) 
// 每 秒 钟 报告 一 次 状态 


setIinterval (function report(){ 


process.send ({cmad: "reportMem", memory: process.memoryUsage(), 
process: process.pid}) 
}, 1000) 
} 
function createWorker() { 
Var worker = cluster.fork() 
console.log('Created worker: ' + worker.pid) 
// 允许 开机 时 间 
workers [worker.pid] = {worker:worker, lastCb: new Date() .getTime ()-1000} 
worker.on('message', function(m) { 
if(m.cmd === "reportMem") { 


workers [m.process] .lastCb = new Date() .getTime () 


if(m.memory.rss > rssWarn) { 
console.log('Worker ' + m.process + ' using 


} 
}) 
} 





作 进 程 向 主 进程 发 送 报告 时 ， 主 进程 都 会 记录 报告 的 时 间 。 
就 会 检查 所 有 的 工作 进程 ， 看 看 是 否 有 某 个 进程 已 经 超过 5 


too much memory.') 


在 这 个 脚本 中 ， 我 们 给 主 进程 也 添加 了 类 似 工作 进程 的 定时 器 。 现 在 ， 每 当 一 个 工 


大 约 每 隔 一 秒 ， 主 进程 
秒 未 更 新 状态 (因为 超 


时 是 以 微 秒 为 单位 ， 所 以 我 们 用 的 是 >5000)。 如 果 发 现 这 样 的 进程 ， 主 进程 将 把 阻 








塞 的 工作 进程 杀 掉 并 重启 。 为 了 让 这 个 流程 更 加 高 效 ， 我 们 把 创建 工作 进程 的 代码 
放 到 一 个 小 程序 里 ， 这 样 就 能 在 同一 个 地 方 为 不 同情 景 提供 启动 工作 ， 无 论 是 创建 
新 的 工作 进程 还 是 重启 死亡 进程 。 


我 们 也 对 HTTP 服务 器 做 了 一 个 小 改动 ， 让 每 个 请 求 有 1/200 的 概率 会 出 错 。 你 可 
以 运行 一 下 脚本 ， 看 看 出 现 错误 的 可 能 。 如 果 你 同时 从 多 个 地 方 发 起 并 行 请 求 ， 就 
能 看 到 整个 代码 是 如 何 运行 的 。 这 些 彻底 分 隔 的 Node 程序 通过 消息 传递 来 进行 交 
互 。 因 为 主 进程 是 简单 的 小 程序 ， 不 会 卡 住 ， 所 以 它 在 任何 情况 下 都 能 够 一 直 检查 
其 他 进程 。 
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第 二 部 分 





API 和 常用 模块 


第 4 章 
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Node 提供 了 许多 API， 其 中 一 些 比 较 重 要 。 这 些 核心 API 是 所 有 Node 应 用 的 支 
柱 ， 你 会 不 停 地 用 到 它们 。 


4.1 Events 


我 们 第 一 个 要 研究 的 API 是 Events API。 这 是 因为 ， 尽 管 抽 人 象 ， 但 它 是 其 他 所 有 
API 工作 的 基础 模块 。 通 过 仔细 查看 这 个 API， 你 就 能 很 好 地 使 用 其 他 所 有 的 API。 


如 果 你 曾经 在 浏览 器 里 开发 过 JavaScript 程序 ， 就 一 定 已 经 使 用 过 Events 了 。 但 
是 ， 浏 览 器 的 事件 模型 是 从 DOM 里 来 的 ， 不 是 JavaScript 本 身 自 带 的 。DOM 的 许 
多 理念 在 其 使 用 情景 之 外 并 没有 太 多 用 处 。 我 们 先 看 看 DOM 模型 的 Events， 然 后 
再 与 Node 的 实现 方式 进行 比较 。 


DOM 是 基于 用 户 交 互 的 用 户 驱 动 型 事件 模型 ， 有 着 一 组 与 树 状 结构 (HTML， 
XML， 等 等 ) 对 应 的 接口 元 素 。 意 思 是 ， 当 用 户 与 接口 的 某 个 特定 部 分 交互 时 ， 对 
应 有 一 个 事件 和 一 个 相关 的 对 象 ， 比 如 某 个 HTML/XML 元 素 被 点 击 或 者 进行 了 其 
他 操作 。 该 操作 对 象 有 父 节 点 ， 并 且 可 能 有 子 节 点 。 因 为 操作 对 象 是 在 一 棵 树 中 ， 
所 以 这 个 模型 包含 了 冒 泡 和 捕获 的 概念 ， 就 是 允许 沿 着 树 的 结构 向 上 或 向 下 的 元 素 
也 接收 被 触发 的 事件 。 


例如 ， 在 一 个 HTML 列表 中 ， 在 <1i> 上 的 一 个 点 击 事件 ， 能 够 被 其 父 布 点 <ul> 
上 绑 定 的 监听 器 所 捕获 。 反 过 来 ，<ul> 上 的 点 击 会 向 下 冒 泡 传 给 <11> 上 的 监听 
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器 。 因 为 JavaScript 对 象 没 有 这 一 类 树 状 结构 ， 所 以 Node 中 的 模型 更 加 简单。 


4.1.1 EventEmitter 

因为 在 浏览 器 中 Event 模型 是 绑 定 在 DOM 上 的 ， 所 以 Node 创建 了 EventEmitter 
类 来 提供 基础 的 事件 功能 。 所 有 Node 的 事件 功能 围绕 着 EventEmitter， 因 为 它 
的 设计 包含 了 其 他 类 扩展 所 需要 的 接口 类 。EventEmitter 对 象 通常 不 会 直接 调用 。 


























EventEmitter 类 提供 了 一 系列 方法 ， 甚 中 最 主要 的 两 个 是 on 和 emit， 这 些 方法 
供 其 他 类 使 用 。on 方法 为 一 个 事件 创建 了 监听 器 ， 如 例 4-1 所 示 。 


例 4-1 使 用 on 方法 监听 事件 


server.on('event', function(a, b, c) { 


// 具体 操作 








}) 


on 方法 接受 两 个 参数 : 需要 监听 的 事件 的 名 称 ， 当 事件 触发 时 需要 调用 的 函数 。 
为 EventEmitter 是 接口 ， 从 EventEmitter 继承 的 类 需要 使 用 new 关键 字 来 构造 。 
让 我 们 看 看 例 4-2 中 如 何 构 造 一 个 监听 器 的 新 类 。 


例 4-2 创建 一 个 新 类 支持 EventEmitter 事件 


var utils = require('utils'), 
EventEmitter = require('events') .EventEmitter; 























var Server = function() { 
console.log('init'),; 


utils.inherits (Server, EventEmitter); 
Var s = new Server(); 


s.on('abc', function() { 
console.log('abc'); 
} 
例子 中 ， 我 们 先 包 含 了 utils 模块 ， 以 便 调用 它 的 inherits 方法 。inherits 
能 够 把 EventEmitter 类 的 方法 添加 到 我 们 创建 的 server 类 中 。 这 意味 着 所 有 
server 的 新 实例 都 能 够 使 用 EventEmitter 的 方法 。 





然后 我 们 包含 了 events 模块 。 但 我 们 只 想 调用 其 模块 中 的 EventEmitter 类 。 注 
意 ，EventEmitter 是 以 大 写字 母 开 始 命名 的 ， 用 来 表示 它 本 身 是 一 个 类 。 我 们 不 
调用 createEventEmitter 方 法 ， 因 为 不 打算 直接 使 用 EventEmitter 实例 ， 只 
是 想 把 它 的 方法 绑 定 到 我 们 要 用 的 server 类 上 。 
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当 包 含 了 所 有 需要 的 模块 后 ， 下 一 步 就 是 创建 基础 的 server 类 。 它 只 提供 了 一 
个 简单 的 函数 ， 就 是 在 初始 化 的 时 候 记 录 一 条 消息 。 在 真实 的 实现 中 ， 我 们 会 为 
Server 类 补充 它 需 要 使 用 的 函数 原型 。 为 了 简单 起 见 ， 我 们 先 把 这 部 分 省 略 了 。 
重要 的 一 步 是 使 用 sys . inherits 把 EventEmitter 作为 超 类 添加 给 server 类 。 


当 需 要 使 用 server 类 时 ， 我 们 用 new Server() 来 实例 化 它 。server 的 实例 能 
够 访问 其 超 类 (EventEmitter) 的 方法 ， 也 就 是 说 我 们 可 以 调用 on 方法 来 为 这 个 
实例 添加 监听 器 。 

到 目前 为 上 下， 我 们 添加 的 事件 监听 器 还 不 会 被 调用 ， 因 为 并 没有 abc 事件 被 触发 。 
我 们 可 以 通过 添加 例 4-3 中 的 代码 来 触发 这 个 事件 。 


例 4-3 触发 一 个 事件 


s.emit ('abc'); 








触发 事件 监听 器 很 简单 ， 只 要 调用 从 EventEmitter 继承 的 server 实例 的 emit 
方法 就 行 了 。 需 要 注意 的 是 ， 这 些 事 件 是 针对 某 个 实例 的 ， 不 存在 全 局 的 事件 。 当 
你 调用 on 方法 的 时 候 ， 需 要 绑 定 在 特定 的 基于 EventEmitter 的 对 象 上 。Server 
类 不 同 的 实例 之 间 也 不 会 共享 事件 。 例 4-3 代码 中 的 s 对 象 不 会 与 另外 一 个 server 
实例 z (比如 var z = new Server()) 共享 同一 个 事件 。 








4.1.2 Callback 语法 

使 用 事件 很 重要 的 一 个 部 分 是 处 理 回 调 函 数 。 第 3 章 已 经 深入 地 探讨 了 其 最 佳 实践 ， 
但 我 们 现在 要 看 看 在 Node 里 回调 函数 的 工作 机 制 。 它 们 采用 了 几 种 标准 模式 ， 我 
们 先 来 看 看 有 哪些 可 能 性 。 

当 调用 emit 时 ， 除 了 事件 的 名 称 ， 你 可 以 传 入 任意 数目 的 参数 。 例 4-4 中 包含 了 3 
个 这 样 的 参数 。 这 些 参 数 都 将 传 给 该 监听 该 事件 的 国 数 。 比 如 ， 从 http 服务 器 接 
收 到 request 请 求 时 ， 你 会 收 到 两 个 参数 : req 和 res。 当 request 事件 被 触发 
时 ， 这 些 参数 会 作为 第 二 个 和 第 三 个 参数 传 给 emit 函数 。 

例 4-4 触发 事件 的 时 候 传递 参数 


s.emit ('abc', a, b, c); 


了 解 Node 如 何 调用 事件 监听 器 很 重要 ， 因 为 这 会 影响 你 的 编程 风格 。 当 emit () 调 
用 包含 变量 时 ， 例 4-5 中 的 代码 会 被 用 来 调用 对 应 的 事件 监听 器 。 


例 4-5 触发 器 里 如 何 调用 事件 


if (arguments.length <= 3) { 
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// 速度 快 

handler.call (this, arguments[1], arguments{[2]); 
} else { 

// 速度 慢 

Var args = Array.prototype.slice.call (arguments, 1); 

handler.apply (this, args); 


} 


这 两 种 代码 都 是 JavaScript 调用 函数 的 方法 。 如 果 传 给 emit () 的 参数 只 有 3 个 
或 更 少 ， 该 方法 就 会 使 用 捷径 ， 直 接 调 用 call 方 法。 否则 ， 它 就 会 使 用 较 慢 
的 apply 方 法 ， 以 数组 的 方式 传递 所 有 的 参数 。 这 里 需要 注意 的 是 ，Node 调用 
这 两 种 方法 时 都 直接 使 用 了 this 参数 。 这 意味 着 事件 监听 器 被 调用 的 时 候 是 在 
EventEmitter 的 上 下 文中 ， 而 不 是 它们 原始 的 位 置 。 通 过 Node 命令 行 解析 器 ， 
你 可 以 清楚 地 看 见 当 EventEmitter 调用 对 象 时 会 发 生 什 么 事情 ( 例 4-6)。 




















例 4-6 EventEmitter 改变 了 人 上下文 


> Var EventEmitter = require('events') .EventEmitter, 
util = require('util'); 


var Server = function() {}; 
util.inherits (Server, EventEmitter); 
Server.prototype.outputThis= function(output) { 
console.log (this); 
console.1log(output); 


[Function] 

此 

> Server.prototype.emitOutput = function(input) { 
this.emit('output', input); 

[Function] 

Es 

> Server.prototype.callEmitOutput = function() { 
this.emitOutput ('innerEmitOutput'); 

[Eunction] 


> Var s = new Server(); 
> s.on('output', s.outputThis),; 








{ _events: { output: [Function] } } 
> s.emitOutput ('outerEmitOutput'); 
{ _events: { output: [Function] } } 
outerEmitOutput 

> s.callEmitOutput (); 

{ _events: { output: [Function] } } 
innerEmitOutput 

> s.emit('output', 'Direct'); 

{ _events: { output: [Function] } } 
Direct 

true 





输 出 例子 中 首先 设置 了 一 个 Server 类 ， 它 包 含 耿 触发 output 事件 的 国 数 。 
outputThis 方法 作为 事件 监听 器 绑 定 在 output 事件 上 。 在 不 同 的 上 下 文中 
触发 output 事件 时 ， 我 们 保持 在 EventEmitter 对 象 所 在 的 作用 域 中 。 所 以 
s.outputThis 能 够 访问 的 this 变量 的 值 是 属于 该 EBventEmitter 的 。 因 此 ， 如 
果 我 们 想 在 事件 回调 函数 中 使 用 this 变量 的 话 ， 就 必须 把 它 作为 一 个 参数 传 入 并 
赋值 到 另外 一 个 变量 上 。 














4.2 HTTP 


Node.js 的 核心 功能 之 一 就 是 作为 Web 服务 器 ， 这 是 这 个 系统 的 一 个 重要 部 分 ， 所 
以 当 Ryan Dahl 发 起 此 项 目 时 ， 他 为 V8 重 写 了 HTTP 模块 ， 使 其 能 够 非 阻塞 运行 。 
虽然 最 开始 的 HTTP 实现 已 经 赔 变 了 许多 ，API 和 内 部 实现 不 断 升 级 ， 但 核心 操作 
还 是 保持 不 变 的 。Node 实现 的 HTTP 模块 是 非 阻 塞 的 ， 且 速度 很 快 ， 其 中 许多 代码 
已 经 从 C 迁移 到 了 JavaScript。 


HTTP 使 用 的 模式 在 Node 里 很 常见 。 父 工厂 类 提供 了 很 容易 创建 新 服务 器 的 方法 '。 
http.createServer() 方法 为 我 们 提供 了 构建 新 的 HTTPserver 类 的 实例 。 我 们 
可 以 为 新 的 类 定义 Node 接受 到 HTTP 请 求 时 的 操作 。HTTP 模块 及 其 他 Node 模块 
还 有 一 些 共性 的 地 方 ， 比 如 server 类 能 够 触发 的 事件 ， 还 有 传 给 回调 函数 的 数据 
结构 。 了 解 这 3 种 类 型 有 助 于 你 更 好 地 使 用 HTTP 模块 。 


4.2.1 HTTP 服 务 器 

HTTP 服务 器 也 许 是 Node 最 常用 的 使 用 情景 了 。 在 第 1 章 中 ， 我 们 设置 了 一 个 
HTTP 服务 器 ， 并 用 它 来 处 理 非常 简单 的 请 求 。 其 实 ，HTTP 还 有 很 多 的 功能 。 
HTTP 模块 的 服务 器 部 分 提供 了 构建 复杂 、 全 面 的 Web 服务 器 的 原始 工具 。 在 本 章 
里 ， 我 们 会 继续 探索 处 理 请 求 及 发 送 响应 的 机 理 。 即 使 你 使 用 了 更 高 级 的 服务 器 杠 
架 (如 Express)， 它 们 背后 采用 的 许多 概念 也 都 是 从 这 里 介绍 的 内 容 延 伸 而 来 的 。 


正如 前 面 的 例子 所 示 ， 使 用 HTTP 服务 器 的 第 一 步 就 是 调用 http.createserver () 
方法 来 创建 一 个 新 的 服务 器 。 这 会 返回 一 个 新 的 server 类 的 实例 ， 里 面 只 包含 少 
数 的 方法 ， 因 为 更 多 的 功能 是 通过 使 用 事件 来 提供 的 。http 服务 器 类 有 6 个 事件 和 
3 个 方法 。 还 要 注意 的 是 ， 大 部 分 方法 只 是 用 来 初始 化 服务 器 ， 而 事件 则 是 用 来 处 
理 它 的 运行 时 操作 。 


让 我 们 从 创建 一 个 最 小 的 HTTP 服务 器 代码 开始 ( 例 4-7)。 























注 1: 当 我 们 提 到 父 类 (pseudoclass) 时 , 指 的 是 Douglas Crockford 所 著 的 JavaScript: The Good Parts (O "Reilly ) 
一 书 中 的 定义 。 从 现在 起 ， 我 们 将 使 用 “类 ”的 说 法 来 代 禁 “ 父 类 ”。 
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例 4-7 非常 简短 的 HTTP 服务 器 


require('http') .createServer (function(req,res) {res.writeHead (200, {}); 
res.end('hello world');}) .listen(8125); 


这 个 例子 并 不 是 好 的 代码 风格 ， 但 是 它 演 示 了 几 个 关键 点 ， 稍 后 我 们 再 改进 代码 风 
格 。 首 先 ， 我 们 用 require 包含 了 http 模块 。 注 意 我 们 使 用 了 链 式 方法 来 使 用 这 
个 模块 ， 而 不 需要 先 赋值 给 一 个 变量 。Node 里 的 许多 东西 会 返回 一 个 函数 ”*"， 这 样 
我 们 就 能 直接 调用 这 些 国 数 了 。 包 含 http 模块 后 ， 我 们 调用 createserver。 这 
里 并 不 是 必须 输入 参数 ， 但 我 们 传人 了 一 个 国 数 ， 并 让 它 绑 定 在 request 事件 上 。 
最 后 ， 我 们 让 createservez 创建 的 服务 器 监听 (1isten) 8125 端口 。 


希望 你 在 真实 情景 下 从 不 需要 写 类 似 的 代码 ， 但 这 里 的 代码 显示 了 语法 的 灵活 和 语言 
的 简洁 。 让 我 们 把 代码 写 得 更 清晰 些 。 例 4-8 中 重 写 的 代码 变 得 更 好 理解 和 维护 了 。 


例 4-8 简短 但 可 读 性 更 好 的 HITP 服务 器 


var http = require('http'); 

Var server = http.createServer () ; 

var handleReq = function(req,res){ 
res.writeHead(200, {}); 
res.end('hello world'); 

}; 

server.on('request', handleReqg); 

server.listen(8125); 


这 个 例子 依旧 是 实现 了 最 小 的 Web 服务 器 ， 但 这 次 ， 我 们 开始 把 东西 赋值 给 命名 变 
量 。 比 起 使 用 链 式 调 用 ， 这 让 代码 变 得 更 容易 读 一 些 ， 而 且 还 可 以 重用 。 例 如 ， 在 
一 个 文件 里 可 能 会 多 次 使 用 http， 这 样 的 情形 并 不 少见 。 如 果 你 想 同 时 使 用 HTTP 
服务 器 和 HTTP 客户 端 ， 重 用 该 模块 对 象 就 会 很 有 用 。 即 使 JavaScript 并 不 菊 你 去 
考虑 内 存 ， 也 不 意味 着 你 可 以 把 不 需要 的 对 象 草 率 地 到 处 乱 扔 。 然 后 我 们 还 是 用 了 
命名 函数 来 处 理 request 事件 ， 用 来 替换 之 前 的 匿名 回调 函数 。 这 与 内 存 使 用 没 什 
么 关系 ， 只 是 增加 了 可 读 性 。 我 们 并 不 是 说 你 不 该 使 用 匿名 函数 ， 但 如 果 可 以 把 代 
码 放 在 容易 查找 的 地 方 ， 会 更 有 助 于 维护 它 。 















































二 位 
阅读 本 书 的 第 一 部 分 可 以 更 好 地 掌握 编程 风格 ， 特 别 是 第 1 章 和 第 2 章 中 关 
人 4 。 于 代码 风格 的 处 理 。 


， 
4 人， 








因为 我 们 没有 在 调用 创建 http 服务 器 对 象 的 工厂 方法 时 传 入 request 事件 监听 器 ， 
所 以 需要 显 式 地 添加 该 事件 监听 器 ， 这 可 以 利用 EventEmitter 调用 on 方法 来 完 
成 。 最 后 ， 和 之 前 的 例子 一 样 ， 我 们 调用 1isten 方法 来 监听 想 要 的 端口 。http 类 








注 2: 这 是 因为 JavaScript 支持 一 等 函数 (first-class functions)。 
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还 提供 了 其 他 函数 ， 这 个 例子 只 是 演示 了 最 重要 的 儿 个 。 


http 服务 器 支持 几 种 事件 ， 都 是 和 客户 端的 TCP 或 者 HITP 连接 相关 联 的 。 
connection 和 close 事件 表示 了 与 客户 端的 TCP 连接 的 建立 与 关闭 。 要 注意 ， 如 
果 客 户 端 使 用 的 是 HTTP 1.1 协议 ， 这 是 支持 keepalive 的 。 这 意味 着 这 些 TCP 连接 
可 能 会 跨越 多 个 HTTP 请 求 。 





request、checkContinue、upgrade 和 clientError 事件 是 关联 在 HTTP 请 求 
上 的 。 我 们 已 经 使 用 过 request 事件 ， 表 示 的 是 新 的 HTTP 请 求 。 


checkContinue 事件 是 一 个 特殊 事件 ， 当 客户 端 以 数据 流 的 方式 将 数据 发 送 给 服务 
器 时 ， 你 可 以 对 HTTP 请 求 进行 更 直接 的 控制 。 客 户 端 发 送 数据 给 服务 器 时 ， 需 要 
检查 当前 状态 下 能 否 继 续 ， 这 就 会 触发 此 事件 。 如 果 这 个 事件 绑 定 了 事件 处 理 顷 ， 
则 request 请 求 就 不 会 被 触发 。 


upgrade 事件 在 一 个 客户 端 请 求 协议 升级 时 会 触发 。 除 非 绑 定 了 此 事件 的 事件 处 理 
恬 ， 否 则 http 服务 颖 将 拒绝 HTTP 升级 请 求 。 


最 后 ，clientError 事件 会 把 客户 端 发 送 的 error 事件 传递 出 来 。 


HTTP 服务 器 可 以 抛 出 若干 事件 ， 最 常见 的 是 request， 但 你 也 会 在 TcP 连接 的 整 
个 生命 周期 中 获得 其 他 事件 。 


当 为 请 求 创建 一 个 新 的 TCP 流 时 ， 就 会 触发 connection 事件 。 这 个 事件 会 把 TcP 
流 作为 参数 传 给 该 请 求 。 该 数据 流 也 可 以 在 request 使 用 的 时 候 ， 通 过 request. 
connection 变量 获得 。 但 每 个 流 只 会 触发 connection 事件 一 次 ， 所 以 可 能 会 


现 从 一 个 客户 端 来 的 多 个 请 求 只 对 应 一 次 connection 事件 的 情况 。 















































4.2.2 ”HTTP 客户 端 


如 果 你 想 向 远程 服务 器 发 起 HTTP 连接 ，Node 也 是 很 好 的 选择 。Node 在 许多 情景 
下 都 很 适合 使 用 ， 如 使 用 Web service， 连 接 到 文档 数据 库 ， 或 是 抓 取 网 页 。 你 可 以 
使 用 同样 的 http 模块 来 发 起 HITP 请 求 ， 但 应 该 使 用 http.clientRequest 类 。 
该 类 有 两 个 工厂 方法 : 一 个 通用 的 方法 和 一 个 便捷 的 方法 。 让 我 们 看 看 例 4-9 的 通 
用 方法 的 例子 。 








例 4-9 创建 HTTP 请 求 
var http = require('http'); 


var opts = { 
host: 'www.google.com' 
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ports 0 
paths "/", 
method: 'GET' 


}; 


var req = http.request (opts, function(res) { 
console.log(res); 
res.on('data', function (data) { 
console.log(data); 
J 
}s 


req.end (); 
你 首先 要 查看 的 是 配置 (options) 对 象 ， 它 定义 了 请 求 的 许多 功能 。 我 们 必须 
提供 host 名 字 (虽然 耳 地 址 也 是 可 以 的 )、 端 口 (port) 和 路 径 (path)。 方 法 
(method) 是 可 选项 ， 如 果 没 有 指定 ， 默 认 会 设置 为 cET。 在 本 质 上 ， 这 个 例子 指 
定 了 往 http://www.google.com/ 的 80 端口 发 起 HTTP GET 请 求 。 





接 下 来 ， 我 们 要 用 配置 (options) 对 象 来 创建 一 个 http .clientRedquest 实例 ， 
就 是 调用 http.request () 这 个 工厂 方法 ， 并 传人 options 对 象 和 回调 国 数 (可 
选 )。 传 入 的 回调 函数 会 监听 response 事件 ， 并 在 接收 到 response 事件 时 ， 处 
理 request 的 数据 。 在 之 前 的 例子 里 ， 我 们 只 是 简单 地 把 response 对 象 打印 到 终端 
上 。 但 要 注意 一 点 ，HTTP 请 求 的 正文 内 容 实 际 上 是 通过 response 对 象 的 数据 流 
获得 的 。 而 且 你 可 以 订阅 response 对 象 的 aata 事件 ， 以 便于 数据 可 用 时 就 能 处 
理 (更 多 信息 请 参见 本 书 4.3.1 市 的 内 容 )。 


最 后 需要 注意 的 一 点 是 ， 需 要 结束 (end()) 该 请 求 。 因 为 这 是 一 个 ET 请求 ， 
所 以 我 们 并 不 会 往 服 务 器 发 送 任何 数据 。 但 对 于 其 他 的 HTTP 方法， 比如 PUT 或 
POST， 你 可 能 需要 发 送 数 据 。request 会 等 待 snd () 方法 调用 后 ， 才 初始 化 HTTP 
请 求 ， 因 为 在 那 之 前 ， 它 不 确定 我 们 是 否 还 会 发 送 数 据 。 











1. 提交 HTTP GET 请 求 


GET 是 很 常见 的 HTTP 使 用 方式 ， 因 此 提供 了 一 个 专门 的 工厂 方法 来 更 方便 地 使 用 
它 ， 如 例 4-10 所 示 。 





例 4-10 ”简单 的 HTTP GET 请 求 


Var http = require('http'); 


var opts = { 
host: "www.google.com' 
Borti 80， 
path: '/', 





var req = http.get (opts, function(res) { 
console.log (res); 
res.on('data', function (data) { 
console.log(data); 


Ds 
})s 
这 个 例子 的 http.get () 和 之 前 的 例子 做 了 一 样 的 事情 ， 但 更 加 明确 。 我 们 把 method 
属性 从 配置 对 象 中 去 掉 了 ， 还 把 request .end() 也 移 除 了 ， 因 为 这 些 都 已 经 隐 含 说 明 
了 。 如 果 运 行 了 这 两 个 例子 ， 你 得 到 的 结果 将 是 Buffer 对 象 的 裸 数 据 。 本 章 后 续 会 介 
绍 到 ，Buffer 是 Node 特殊 定义 的 类 ， 用 来 支持 任意 二 进 制 数据 的 存储 。 虽 然 你 也 可 
以 直接 使 用 这 些 内 容 ， 但 通常 要 指定 编码 方式 ， 如 UTF-8 (一 种 Unicode 字符 的 编码 格 
式 )， 这 可 以 通过 response .setEncoding () 方法 来 指定 ( 例 4-11)。 


例 4-11 对 比 裸 Buffer 输出 与 指定 编码 格式 的 输出 


> Var http = require('http'); 
> Var req = http.get ({host:'www.google.com', bortse0, pathz yl}, 
function(res) { 

. Console.logl(res); 

. res.on('data', function(c) { console.log(c); }); 

= 


> <Buffer 3C 21 64 6f 63 74 79 70 





65 2e 73 74> 
<Buffer 61 72 74 54 69 


69 70 74 3e> 


> 
> var req = http.get ({host:'www.google.com', port:80, path:'/'}, 
function(res) { 

. res.setEncoding('utf8°'); 

.. res.on('data', function(c) { console.log(c); }); 

ss 


> <!doctype html><html><head><meta http-equiv="content-type 


load.t.prt=(f=(new Date) .getTime ()); 
的 全 过 


</script> 


在 第 一 个 例子 中 ,我 们 没有 调用 clientResponse.setEncoding()， 而 且 得 到 的 
是 Buffer 中 的 块 数据 。 虽 然 输出 是 简略 的 打印 内 容 ， 但 也 能 看 出 并 非 只 有 一 个 
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Buffer， 而 是 分 开 了 几 个 Buffer 才 把 数据 返回 完整 。 在 第 二 个 例子 中 ， 因 为 我 们 
设置 了 res.setEncoding('utf8')， 数 据 以 UTF-8 的 格式 返回 了 。 从 服务 器 返 
回 的 数据 还 是 一 样 ， 分 成 了 几 块 ， 但 这 次 发 给 程序 的 是 以 正确 的 编码 显示 的 字符 串 ， 
而 不 再 是 Buffer 的 裸 数据 。 虽 然 打 印 的 内 容 可 能 表现 得 还 不 够 明显 ， 但 每 个 原始 
Buffer 对 应 打印 出 来 的 都 是 一 个 字符 串 。 








2. 发 送 HTTP POST 和 PUT 数据 


不 是 所 有 的 HTTP 请 求 都 是 用 GET 方法 的 ， 你 还 需要 调用 posT、PUT 和 其 他 HTTP 
方法 ， 它 们 会 改变 对 方 的 数据 。 这 和 发 送 GET 请 求 的 功能 一 样 ， 只 不 过 你 还 需要 往 
上 发 送 一 些 数据 ( 例 4-12)。 


例 4-12 往 上 传 服务 写 入 数据 


var options = { 
host: 'www.example.com', 
port:; 80, 


path: '/submit', 
method: 'POST' 


}; 


var req = http.request (options, function(res) { 
res.setEncoding('utf8'); 
res.on('data', function (chunk) { 
console.1log('BODY: ' + chunk) ; 


} 
}s 


req.write("my data"); 
req.write("more of my data"); 


req.end () ; 


这 个 例子 和 例 4-10 很 相似 ， 但 增加 了 nttp.clientRequest.write() 方法 。 
可 以 用 这 个 方法 发 送 上 行 数 据 流 。 之 前 解释 过 ， 它 要 求 你 显 式 地 调用 http. 
ClientRequest.end() 方法 来 表示 数据 发 送 完 毕 。 每 当 调 用 clientRequest. 
write() 时 ， 数 据 会 马上 上 传 (不 会 被 缓存 ) ， 但 服务 器 在 clientRequest .end () 
调用 之 前 是 不 会 响应 你 的 数据 请 求 的 。 

你 可 以 把 一 个 流 (Stream) 的 aata 事 件 和 clientReduest.write() 绑 定 在 一 起 ， 
这 样 就 能 把 数据 以 流 的 形式 发 送 给 服务 器 了 。 比 如 当 需 要 把 硬盘 上 的 一 个 文件 通过 
HTTP 发 送 给 远程 服务 器 时 ， 这 会 是 个 好 主意 。 








3. ClientResponse 对 象 


ClientResponse 对 象 保存 了 关于 请 求 的 许多 信息 ， 而 且 都 很 直观 。 它 的 一 些 显著 
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的 属性 也 很 有 用 ， 包 括 statuscode (包含 了 HTTP 状态 ) 和 neader 属性 (响应 
头 对 象 ) 。clientResponse 上 还 挂 了 多 个 数据 流 和 属性 ， 你 也 许 会 直接 使 用 它 。 


4.2.3 URL 


URL 模块 提供 了 解析 和 处 理 URL 字符 串 的 便利 工具 ， 当 你 需要 和 URL 打交道 时 
会 非常 有 用 。 该 模块 提供 了 3 个 方法 : parse、format 和 resolve。 我 们 先 从 例 
4-13 开始 ， 在 Node 命令 行 里 演示 如 何 使 用 parse。 





例 4-13 用 URL 模块 解析 URL 


> Var URL = require('url'); 


> Var myUrl = "http://www.nodejs.org/some/url/?with=query&param=that&are= 
awesome#alsoahash"; 

> myUrl 
'http://www.nodejs.org/some/url/?with=query&param=that&are=awesome 
#alsoahash' 


> parsedUrl1 = URL.parse (myUr1); 

{ href: 'http://www.nodejs.org/some/url/?with=query&param=that&are= 
awesome#alsoahash' 

: Brotocols: "https" 

， Slashes: true 

,， host: 'www.nodejs.org' 

， hostname: 'www.nodejs.org' 

,， hash: '#alsoahash' 


， Search: '?with=query&param=that&are=awesome' 
, duery: 'with=query&param=thatt&are=awesome' 
pathname: '/some/url/' 


} 
> parsedUrl1 = URL.parse (myUrl1l, true); 
{ href: 'http://www.nodejs.org/some/url/?with=query&param=that&are= 
awesome#alsoahash' 
六 Brotocols "httpe" 
， slashes: true 
， host: 'www.nodejs.org' 
， hostname: 'www.nodejs.org' 
,， hash: '#alsoahash' 
， Search: '?with=query&param=that&are=awesome' 
， query: 
{ with: 'query' 
， param: 'that' 
， are: 'awesome! 


} 


,， pathname: '/some/url/' 


} 
第 一 件 事 情 当 然 是 要 先 包含 URL 模块 。 注 意 所 有 的 模块 名 称 都 是 小 写 的 。 我 们 创建 
的 url 字符 串 包 含 了 需要 被 解析 的 所 有 部 分 。 解 析 真 的 很 简单 : 只 要 对 该 字符 串 调 
用 URL 模块 的 parse 方法 。 它 返回 的 数据 结构 代表 了 解析 出 来 的 URL 的 各 个 部 分 ， 
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它 产 生 的 组 成 部 分 如 下 : 


。 href 

。 protocol 
。 host 

。 auth 

。 hostname 
.Bort 

。 pathname 
。 search 

“ query 

。 hash 


href 是 原始 输入 用 来 解析 的 完整 URL。protocol 是 用 在 URL 里 的 协议 (如 
http://、https://、ftp:// 等 )。host 是 URL 里 完整 的 hostname。 这 可 以 
是 本 地 服务 器 的 hostname， 比 如 打印 机 服务 器 ， 也 可 以 是 如 www.google.com 一 
样 完整 的 域名 。 它 还 可 能 包含 了 端口 (如 8080)， 或 用户 名 和 密码 (如 un:pwe@ 
ftpserver.com)。hostname 的 不 同 部 分 会 进一步 细 分 到 : auth (包含 用 户 证 书 )、 
port (单纯 是 端口 )、hostname (包含 URL 的 主机 名 )。 重 点 是 ，hostname 依 
然 是 完整 的 主机 名 ， 包 含 了 顶级 域名 (如 .com 和 .net 等 ) 和 特定 的 服务 器 。 如 
果 URL 是 http://sport.yahoo.com/nhl，nostname 不 会 单独 给 你 顶级 域名 (yahoo. 
com) 或 只 给 你 主机 (sport)， 而 是 会 给 你 完整 的 主机 名 (sport .yahoo.com)。 
URL 模块 并 没有 能 力 把 hostname 细 分 成 单独 的 部 分 ， 如 域名 或 顶级 域名 。 


URL 的 下 一 组 成 员 是 关于 host 部 分 后 面 的 所 有 东西 。pathname 是 跟 在 host 之 后 
的 整个 文件 路 径 ， 例 如 http://sports.yahoo.com/nhl 的 bathname 就 是 /nhl。 下 一 个 
是 search 部 分 ,保存 了 URL 中 HTTP GET 的 参数 。 比 如 URL 是 http://mydomain. 
com/?foo=bar&baz=qux，search 部 分 对 应 的 是 ?f00=bargbaz=qux。 注 意 它 包含 
了 ?。query 参数 和 search 部 分 类 似 ， 它 包含 二 者 中 的 一 项 ， 具 体 要 看 parse 被 
调用 的 方法 。 


parse 可 以 有 两 个 参数 : url 字符 串 ， 及 一 个 可 选 的 布尔 值 ， 用 来 确定 querystring 
是 否 该 用 querystring 模块 来 解析 〈 下 一 小 节 再 详细 介绍 )。 如 果 第 二 个 参数 是 
false, query 将 包含 一 个 与 search 类 似 的 字符 串 ， 但 去 掉 了 开头 的 2。 如 果 你 没 
有 传人 第 二 个 参数 ， 那 么 默认 为 false。 


URL 的 最 后 一 个 部 分 是 片段 部 分 〈 称 为 hash)。 这 是 URL 中 在 # 之 后 的 部 分 。 
通常 ， 这 是 用 来 指向 HIML 页 面 内 的 命名 锚 记 (anchor)。 比 如 http://abook. 
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com/#chapter2 可 能 是 指向 包含 整 书 内 容 的 网 页 的 第 2 章 。 在 这 个 例子 中 ，hash 部 
分 就 包含 了 #chapter2。 同 样 ， 该 字符 串 包含 了 “#”。 有 些 网 站 ， 如 http://tiwtter. 
com， 使 用 更 复杂 的 片段 来 做 AJAX 应 用 ， 但 基本 原则 是 一 样 的 。 所 以 假如 用 户 
mentions 的 Twitter 账号 URL 是 http:Wtwitter.com/#!/mentions， 那 么 它 的 pathname 





是 /, 但 hash 是 #!/mentions。 


4.2.4 querystring 


querystring 模块 是 用 来 处 理 query 字符 串 的 简单 辅助 模块 。 上 一 小 节 已 经 讨论 
过 ，query 字符 串 是 在 URL 尾部 编码 过 的 参数 。 但 是 如 果 只 是 把 它 当 做 JavaScript 
字符 串 来 使 用 时 ， 处 理 这 些 参数 未 免 很 烦 珊 。querystring 模块 提供 了 从 query 
字符 串 中 轻松 提取 对 象 的 方法 。 它 的 主要 功能 有 parse 和 decode， 还 包括 一 些 内 
部 辅助 函数 ， 如 escape、unescape、unescapeBuffer、encode 和 stringify。 
如 果 你 有 一 个 query 字符 串 ， 你 可 以 使 用 parse 来 把 它 变 成 一 个 对 象 ( 例 4-14)。 


例 4-14 在 Node 终端 里 使 用 querystring 模块 解析 查询 字符 串 


> Var qs = require('gquerystring'); 
> qs.parse('a=1&b=2&c=d'); 

{ a: i } 

Ed 





例子 中 ， 该 类 的 parse 方法 把 query 字符 串 转 换 成 为 一 个 对 象 ， 其 中 属性 是 对 应 
query 字符 串 中 的 关键 字 和 变量 值 。 你 还 需要 注意 几 件 事 情 。 第 一 ， 数 字 是 返回 成 
字符 串 的 ， 并 非 数字 类 型 。JavaScript 是 弱 类 型 语言 ， 用 一 个 数值 运算 就 能 够 轻松 
把 一 个 字符 串 强 制 转换 成 数字 。 但 是 需要 时 刻 考 虑 那些 无 法 强制 转换 的 情况 。 


其 次 要 注意 的 是 ， 你 传 入 的 query 字 符 串 不 能 包含 URL 中 标记 的 ?。 一 个 典型 
的 URL 例子 是 http:Wwww. bobsdiscount.com/?item=304&location=san+francisco。 
query 字符 串 以 ? 开始， 表示 文件 路 径 已 经 结束 。 但 如 果 你 把 ? 也 包含 在 传 进去 解 
析 的 字符 串 中 ， 第 一 个 关键 字 就 以 ? 开头 了 ， 你 肯定 不 想得到 这 样 的 结果 。 


这 个 库 在 许多 使 用 情景 下 都 非常 有 用 ， 因 为 除了 URL 外 ， 很 多 地 方 会 使 用 到 query 
字符 串 。 当 你 从 一 个 HTTP PosT 发 送 的 内 容 是 x-formencoded 格式 的 时 候 ， 它 也 
是 以 query 字符 串 的 形式 呈现 的 。 所 有 的 浏览 器 厂商 都 为 这 一 做 法 制定 了 标准 。 默 
认 情 况 下 ，HTML 里 的 form 都 会 用 这 个 方式 发 送 数据 到 服务 器 上 去 。 

querystring 模块 也 被 URL 模块 用 作 辅 助 模 块 。 特 别 是 在 解析 URL 的 时 候 ， 你 唱 


以 指定 URL 模块 把 query 字符 串 转 换 成 对 象 返 回 给 你 ， 而 不 是 给 你 一 个 简单 的 字符 
串 。 这 在 上 一 小 节 已 经 详细 介绍 过 了 ， 但 parse 方法 是 使 用 了 querystring 模块 
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来 解析 的 。 


querystring 另外 一 个 重要 的 部 分 是 sncode ( 例 4-15)。 该 函数 把 输入 的 key- 
value 格式 的 对 象 转换 成 query 字符 串 的 格式 。 如 果 你 需要 使 用 HTTP 请 求 (特别 是 
POST 数据) ， 这 会 非常 方便 。 你 可 以 在 操作 时 使 用 JavaScript 对 象 ， 然 后 在 需要 进 
行 数据 传输 时 再 轻松 地 把 它 编 码 成 需要 的 格式 。 所 有 的 JavaScript 对 象 都 可 以 使 用 ， 
但 最 好 是 使 用 的 对 象 只 包含 需要 的 数据 ， 因 为 encoge 方法 会 把 对 象 所 有 的 属性 都 
添加 进来 。 但 是 ， 如 果 属 性 的 值 不 是 string、Boolean 或 number 中 的 一 种 ， 它 就 不 
能 被 序列 化 ， 返 回 的 内 容 中 关键 字 (key) 对 应 的 值 会 是 空 的 。 


例 4-15 “把 对 象 编码 成 查询 字符 串 


» Var myOBj] = 人 (71317 "D'S "ceats'y fune's funcetion() {console. 
log('dogs')}} 

> qs.encode (myObj); 

'a=l&b=5&c=cats&func=" 


> 





4.3 1/O 


LO 是 Node 有 别 于 其 他 框架 的 核心 模块 之 一 。 本 节 将 探索 Node 中 提供 非 阻 塞 IO 
的 API。 





4.3.1 数据 流 (stream ) 

Node 中 的 许多 组 件 提供 了 连续 输出 或 可 连续 处 理 输入 的 功能 。 为 了 让 这 些 组 件 行 
为 一 致 ，stream API 提供 了 一 个 抽象 的 接口 。 该 API 提供 了 常用 的 方法 ， 以 及 数 
据 流 具体 实现 时 需要 使 用 的 属性 。 数 据 流 分 为 可 读 、 可 写 和 可 读 写 。 所 有 的 流 都 是 
EventEmitter 的 实例 ， 也 就 是 说 可 以 主动 触发 事件 。 


可 读 的 数据 流 


可 读 的 数据 流 API 是 一 组 方法 和 事件 ， 提 供 了 数据 源 在 发 送 时 访问 数据 块 的 功能 。 
基本 上 ， 可 读数 据 流 是 与 触发 aata 事件 相关 的 。 这 些 事 件 流 就 代表 了 数据 的 流 形 
式 。 为 了 更 加 可 控 ， 数 据 流 还 提供 了 一 些 功能 让 你 可 以 配置 返回 数据 的 大 小 和 速度 。 


最 基本 的 流 如 例 4-16 所 示 ， 它 从 一 个 文件 里 把 数据 分 块 读 取 。 每 当 一 个 新 的 数据 块 
准备 好 的 时 候 ， 它 会 把 数据 以 变量 aata 的 形式 传 给 回调 函数 。 在 这 个 例子 里 ， 我 
们 只 是 简单 地 把 数据 记录 到 终端 。 但 在 实际 使 用 场景 中 ， 你 可 以 把 数据 以 流 的 形式 
发 送 到 其 他 地 方 ， 或 者 把 它 积 栅 起来， 然后 再 一 并 处 理 。 其 实 ，aata 事件 只 提供 了 
访问 数据 的 方法 ， 你 需要 想 出 如 何 处 理 每 次 返回 的 数据 块 。 























68 | 第 4 章 


例 4-16 创建 可 读 文 件 流 


var fs = require('fs'); 
var filehandle = fs.readFile('data.txt', function(err, data) { 
console.1log (data) 


] ) ; 





让 我 们 进一步 看 看 一 种 处 理 数 据 流 的 常用 模式 。 有 时 候 我 们 需要 等 待 完整 的 数据 都 
可 用 后 再 进行 操作 ， 在 这 种 情况 下 就 会 用 到 数据 池 模式 (spooling pattern) 。 我 们 知 
道 重点 是 不 要 让 Node 的 事件 循环 阻塞 ， 所 以 即使 不 想 在 接收 到 所 有 数据 之 前 进行 
下 一 步 处 理 ， 也 不 希望 堵塞 事件 循环 。 在 这 种 情况 下 〈 例 4-17)， 我 们 使 用 数据 流 
来 读 取 数 据 ， 但 只 有 在 接收 到 足够 的 内 容 后 才 使 用 这 些 数据 。 通 常 “足够 ”的 意思 
是 指数 据 流 已 经 结束 ， 当 然 也 可 能 是 其 他 条 件 。 

















例 4-17 使 用 缓冲 池 模 型 来 读 取 完整 的 流 数 据 
//stream 是 个 抽象 的 数据 流 


var spool = "" 

stream.on('data', function (data) { 
spool += data; 

3 

stream.on('end', function() { 
console.log(spool); 


] ) ; 


4.3.2 文件 系统 

文件 系统 模块 显然 非常 有 用 ， 因 为 你 需要 它 来 访问 磁盘 上 的 文件 。 它 几乎 模仿 了 文 
件 VO 的 POSIX 风格 。 这 个 独特 的 模块 为 它 所 有 的 功能 都 提供 了 异步 和 同步 的 方 
法 。 但 是 ， 我 们 强烈 建议 你 使 用 异步 的 方法 ， 除 非 你 是 用 Node 来 创建 命令 行 脚本 。 
即使 这 样 ， 通 常 使 用 异步 版 本 也 会 更 好 ， 虽 然 会 增加 一 点 点 代码 ， 但 你 可 以 并 行 访 
问 多 个 文件 ， 并 缩减 脚本 运行 的 时 间 。 











人 们 在 处 理 异 步调 用 时 过 到 的 主要 问题 是 执行 次 序 具 有 不 确定 性 ， 特 别 是 处 理 文件 I 
O 时 。 人 们 常常 会 想 要 同时 进行 一 些 操 作 ， 如 文件 移动 、 重 命名 、 复 制 、 读 写 等 ,但 
是 其 中 一 些 操作 依赖 于 另 一 些 操作 ， 所 以 当 执行 完成 的 次 序 不 能 确定 时 ， 可 能 会 出 现 
问题 。 这 意味 着 代码 中 先 执行 的 操作 ， 有 可 能 会 在 第 二 个 操作 之 后 才 完成 。 有 些 模 式 
能 够 很 容易 地 解决 次 序 问 题 ， 我 们 在 第 3 章 已 经 详细 讨论 过 ， 在 这 里 再 重 温 一 下 。 





考虑 一 下 例 4-18 中 的 情况 ， 读 取 文 件 然后 把 它 删 除 掉 。 如 果 删 除 (unlink) 发 生 在 
读 取 之 前 ， 就 不 可 能 读 取 到 文件 的 内 容 了 。 


例 4-18 异步 读 取 并 删除 文件 一 一 但 这 是 错误 的 


Var fs = require('fs'); 
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fs.readFile('warandpeace.txt', functionl(e, data) { 
console.log('War and Peace: ' + data); 


ps: 


fs.unlink('warandpeace.txt'),; 


需要 注意 的 是 ， 我 们 使 用 了 异步 方法 ， 并且 还 创建 了 回调 函数 ， 但 是 并 没有 写 任 何 
代码 来 指定 这 些 函数 调用 的 次 序 。 这 对 于 不 熟悉 使 用 事件 循环 来 编程 的 程序 员 来 说 ， 
通常 会 导致 一 些 问题 。 这 个 代码 表面 上 看 起 来 没 问 题 ， 但 运行 起 来 有 时 候 能 正常 工 
作 ， 有 时 候 却 不 能 。 需 要 使 用 一 种 模式 ， 让 我 们 可 以 指定 想 要 运行 的 次 序 。 有 儿 种 
方法 可 实现 这 一 点 ， 其 中 一 种 常用 的 方法 是 采用 回调 函数 符 套 。 在 例 4-19 中 ， 删 除 
文件 的 异步 调用 是 对 入 在 异步 读 取 文 件 的 回调 函数 中 的 。 


例 4-19 通过 艇 入 回调 函数 完成 异步 读 取 并 删除 文件 





var fs = require('fs'); 
fs.readFile('warandpeace.txt', functionl(e, data) { 
console.log('War and Peace: ' + data); 


fs.unlink('warandpeace.txt'),; 


}); 





这 个 方法 通常 能 够 有 效 地 把 一 组 操作 分 离开 。 我 们 的 例子 中 只 有 两 个 操作 ， 很 容易 
就 能 读 懂 理解 。 但 这 个 模式 有 了 时候 也 可 能 会 失去 控制 。 











4.3.3 Buffer 


虽然 Node 也 是 使 用 JavaScript， 但 它 是 在 JavaScript 通常 使 用 的 环境 外 运行 的 。 比 
如 ， 浏 览 器 需要 JavaScript 来 进行 许多 操作 ， 但 并 不 包括 处 理 二 进 制 数据 。 虽 然 说 
JavaScript 支持 字 节 位 操作 ， 但 它 并 没有 二 进 制 数据 的 原生 表现 形式 。 当 你 考虑 到 
JavaScript 里 数字 类 型 系统 的 限制 时 ， 更 是 会 头疼 不 已 ， 最 后 会 变 成 只 好 采用 二 进 
制 形式 。Node 带 来 了 Buffer 类 ， 为 你 操作 二 进 制 数据 弥补 了 短 板 。 


Buffer 是 V8 引擎 上 的 扩展 ， 这 意味 着 它 有 其 固有 的 一 些 限制 。Buffer 实际 上 
是 对 内 存 的 直接 分 配 ， 这 意味 着 这 多 少 受 制 于 你 在 低级 计算 机 语言 方面 的 经 验 。 
JavaScript 的 其 他 数据 类 型 都 把 存储 数据 的 复杂 性 进行 了 抽象 ， 而 Buffer 与 它们 不 
同 ， 它 提供 的 是 内 存 的 直接 操作 。 创 建 了 一 个 Buffer 后 ， 它 的 大 小 就 固定 了 。 如 
果 你 需要 添加 更 多 的 数据 ， 就 必须 把 老 的 Buffer 复制 到 一 个 更 大 的 Buffer 中 。 
虽然 有 些 特性 看 起 来 让 人 诅 形 ， 但 它们 让 Buffer 能 够 在 服务 器 上 快速 地 处 理 大 
量 的 数据 操作 。 这 是 一 个 特意 的 设计 选择 ， 为 了 性 能 而 牺牲 了 一 些 程序 员 的 开发 
便利 。 




















1. 二 进 制 的 快速 入 门 


我 们 觉得 有 必要 在 这 里 插入 使 用 二 进 制 数据 的 快速 入 门 内 容 ， 一 方面 是 为 了 那些 并 
没有 太 多 二 进 制 数据 处 理 经 验 的 读者 ， 另 一 方面 ， 对 于 那些 很 久 没 处 理 二 进 制 数据 
的 读者 来 说 ， 正 好 也 可 以 回顾 一 下 (就 像 我 们 开始 使 用 Node 时 的 情况 一 样 )。 大 多 
数 人 都 知道 ， 计 算 机 的 工作 原理 是 操作 “ 开 ” 和 “ 关 ” 状 态 。 因 为 只 有 这 样 两 种 状 
态 ， 所 以 我 们 称 此 为 二 元 状态 。 计 算 机 的 所 有 东西 都 建立 在 此 基础 上 ， 这 就 说 明了 
为 什么 在 计算 机 上 操作 时 ， 直 接 操作 二 进 制 通常 是 最 快 的 方法 。 要 做 更 复杂 的 事情 
时 ， 我 们 把 比特 (bit， 每 一 位 表示 一 个 二 元 状态 ) 集合 成 8 个 一 组 ， 称 之 为 8 位 字 
节 (octet)， 也 就 是 通常 所 说 的 字 节 (byte)。 这 样 我 们 就 能 表示 除了 0、!1 外 的 其 
他 数字 了 。 

利用 8 位 字 节 ， 我 们 就 可 以 表示 从 0 到 255 间 的 所 有 数字 了 。 最 右边 的 位 表示 1， 
然后 每 向 左 移动 一 位 ， 把 它 的 表示 值 乘 以 2。 要 计算 某 个 字 节 表示 的 数字 ， 只 要 简 
单 地 把 对 应 位 置 上 的 数 加 起 来 就 知道 了 ( 例 4-20) 。 














例 4-20 ”在 一 个 字 节 里 表示 0 到 255 


128 64 32 16 8421 


0 0 0 0 0000=0 


128 64 32 16 8421 


上 上 .二 直人 55 


128 64 32 16 8 4 2 1 


工 0 0 1 0101=149 


你 还 将 接触 到 许多 采用 十 六 进 制 表示 法 (hex) 的 地 方 。 因 为 字 节 需要 用 简单 的 方式 
来 描述 ,但 8 个 0 和 1 组 成 的 字符 串 并 不 够 方便 ， 所 以 十 六 进 制 表示 法 便 流行 起 来 。 
二 进 制 表示 法 的 基数 是 2， 因 此 每 个 数字 (0 或 1) 只 有 两 种 状态 。 十 六 进 制 使 用 的 
基数 是 16， 每 一 位 能 够 表示 0 到 下 种 状态 ， 其 中 字母 A 到 F (或 对 应 的 小 写字 母 ) 
对 应 代表 10 到 15。 十 六 进 制 非常 方便 的 地 方 在 于 ， 我 们 只 需要 2 个 字母 就 能 表示 
整个 字 节 了 。 最 右 的 位 表示 1， 往 左 一 位 就 表示 16。 如 果 我 们 要 表示 数字 149， 就 
等 价 于 (16x9) + (5x1)， 也 就 是 十 六 进 制 的 95。 


例 4-21 用 十 六 进 制 表示 0 到 255 
十 六 进 制 转换 到 十 进 制 : 




















注 3: 并 没有 “标准 ”的 字 节 大 小 , 但 实际 上 现在 人 们 使 用 的 通常 是 8 位 字 节 。 因 此 8 位 字 节 (octet) 和 字 
节 (byte) 是 等 价 的 ， 我 们 会 采用 更 常见 的 术语 字 节 (byte) 来 指 代 特定 的 8 位 字 节 。 
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0123456789AA Be D E FE 


OTL2345 6 7 8 9 10 11 12 13 14 15 


十 六 进 制 法 计数 : 


业 6. .1 
二 
16 1 

四 = 255 
16 1 

加 5 = 149 


在 JavaScript 中 ， 用 一 个 十 六 进 制 值 表 示 数 字 时 ， 需 要 在 其 十 六 进 制 数 值 前 添加 
ox 标记 。 比 如 ，ox95 表示 十 进 制 数字 149。 在 Node 里 ， 你 会 常常 看 见 console . 
1og() 输出 ， 或 是 在 Node 命令 行 中 ，Buffer 值 是 采用 十 六 进 制 表示 的 。 例 4-22 
演示 了 如 何 用 Buffer 保存 3 个 字符 (比如 RGB 颜色 值 )。 








例 4-22 用 8 位 字 节 数组 创建 一 个 3 个 字 节 的 Buffer 

> new Buffer([255,0,149]); 

<Buffer ff 00 95> 
那么 二 进 制 如 何 表示 其 他 类 型 的 数据 呢 ? 前 面 我 们 已 经 看 见 如 何 用 二 进 制 来 表示 数 
字 了 。 在 网 络 协 议 中 ， 通 常会 指定 一 些 字 符 来 传达 信息 ， 比 如 用 固定 位 置 上 的 比特 
来 表示 特殊 的 含义 。 举 个 例子 ， 在 DNS 请 求 中 ， 头 两 个 字 节 表示 的 数字 是 事务 ID， 
下 一 个 字 市 的 每 个 比特 都 是 独立 使 用 的 ， 每 一 位 表示 了 在 这 个 请 求 中 是 否 使 用 DNS 
的 某 个 功能 。 


二 进 制 另 外 一 种 非常 常用 的 情况 是 用 来 表示 字符 串 。 其 中 使 用 最 多 的 字符 串 编码 方 
式 是 ASCII 和 UTF (通常 是 UTF-8)。 这 些 编 码 方式 定义 了 如 何 把 比特 转换 成 字符 。 
我 们 不 会 在 此 深入 地 展开 讨论 ， 但 基本 上 ， 编 码 的 工作 原理 就 是 采用 一 个 查找 表 把 
字符 映射 到 对 应 的 数字 上 。 要 把 编码 后 的 内 容 转 换 回 来 ， 计 算 机 只 要 通过 查找 转换 
表 ， 就 能 把 数字 变 成 字符 。 


ASCII 字 符 〈 其 中 包含 非 可 见 字 符 ， 如 回 车 ) 一 定 是 正好 每 个 都 是 7 位 大 小 的 ， 
此 能 表示 0 到 127 之 间 的 数值 。 字 符 中 的 第 8 位 比特 通常 用 来 扩展 字符 集 ， 表 示 各 
种 国际 化 的 字符 (如 y 或 6)。 


UTEF 则 要 复杂 一 些 。 它 的 字符 集 包 含 了 非常 多 的 字符 ， 包 括 许多 国际 化 字符 。 每 个 


























以 
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UTF-8 字符 需要 至 少 1 个 字 节 ， 最 多 的 时 候 需 要 4 个 字 节 才能 表示 。 实 质 上 ， 头 128 
个 值 是 传统 的 ASCI， 其 他 的 值 被 推 到 了 映射 表 的 更 远 的 地 方 ， 通 过 更 大 的 数字 来 表 
示 。 当 一 个 罕见 的 字符 被 引用 时 ， 通 过 第 一 个 字 节 表示 的 数字 ， 会 告诉 计算 机 利用 下 
一 个 字 节 从 映射 表 的 第 二 页 中 查找 字符 的 实际 址 。 如 果 该 字符 不 在 映射 表 的 第 二 页 ， 
第 二 个 字 节 会 告诉 计算 机 去 查找 第 三 页 ， 以 此 类 推 。 这 意味 着 在 UTF-8 中 ， 字 符 串 对 
应 的 长 度 并 不 是 与 字 节 数 的 长 度 一 样 。 而 ASCII 中 ， 这 两 个 长 度 是 永远 一 致 的 。 


2. 二 进 制 与 字符 串 


需要 重点 记 住 的 是 ， 一旦 你 把 内 容 复制 到 一 个 Buffer 后 ， 它 就 会 以 二 进 制 的 形式 
存储 起 来 。 当 然 ， 你 可 以 随时 把 Buffer 中 的 二 进 制 内 容 转 换 成 其 他 形式 ， 比 如 说 
字符 串 。 所 以 Buffer 只 由 它 的 大 小 来 定义 ， 而 非 通过 编码 或 者 其 他 任何 指示 含义 
的 方式 。 

既然 Buffer 是 不 透明 的 ， 那 么 它 需要 多 大 才能 把 输入 的 特定 字符 串 保存 起 来 呢 ? 
正如 前 面 我 们 介绍 的 ， 一 个 UTF 字符 可 能 会 占用 最 多 4 个 字 闻 。 因 此 为 安全 起 见 ， 
需要 定义 一 个 Buffer 的 大 小 为 可 能 输入 的 UFT 字符 最 大 值 的 4 倍 大 小 。 你 可 以 采 
取 一 些 方法 来 减轻 这 个 负担 ， 比 如 限制 输入 只 能 为 欧洲 语言 ， 这 样 就 能 确定 每 个 字 
符 最 大 为 2 个 字 节 了 。 


3. Buffer 的 使 用 


创建 Buffer 可 以 使 用 3 种 参数 : 指定 Buffer 的 字 节 长 度 ， 需 要 找 贝 到 Buffer 里 
的 字 节 数组 ， 或 是 需要 拷贝 到 Buffer 里 的 字符 串 。 第 一 和 最 后 一 种 方法 是 目前 最 
常 使 用 的 。 在 一 些 不 常见 的 情况 下 ， 你 会 需要 用 一 个 JavaScript 的 字 节 数组 。” 


创建 特定 大 小 的 Buffer 是 很 常见 的 情况 ， 而 且 容 易 处 理 。 你 只 需 在 创建 Buffer 
的 时 候 指定 需要 的 字 市 大 小 作为 参数 就 可 以 了 ( 例 4-23)。 


例 4-23 指定 字 节 长 度 创建 Buffer 


> new Buffer(10); 
<Buffer el 43 17 05 01 00 00 00 41 90> 
> 


正如 你 在 前 一 个 例子 中 所 见 ， 创 建 Buffer 后 ， 得 到 了 一 个 对 应 长 度 的 字 节 组 。 但 
是 ， 因 为 Buffer 是 从 内 存 直接 分 配 的 ， 它 并 不 会 对 原 有 的 内 容 进 行 初始 化 ， 所 以 
得 到 的 内 容 就 是 原本 占用 的 东西 。 这 与 原生 的 JavaScript 类 型 不 同 ， 它 们 会 把 所 有 
的 内 存 初 始 化 ， 无 论 你 是 创建 一 个 新 的 原生 变量 还 是 对 象 ， 它 都 不 会 把 原本 内 存 空 


注 4: 其 中 一 个 原因 是 这 样 非常 浪费 内 存 。 比 如 ， 车 把 每 个 字 市 作为 一 个 数字 保存 ， 你 需要 使 用 64 位 大 小 
的 内 存 空间 来 表示 一 个 8 位 大 小 的 内 容 。 
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间 的 垃圾 数据 返回 给 你 。 你 可 以 用 下 面 的 情景 来 帮助 理解 。 假 设 你 到 了 一 家 繁忙 的 
咖啡 店 ， 想 找 一 张 桌子 时 ， 最 快 的 方法 就 是 一 旦 有 人 离开 了 就 立马 坐 下 来 。 虽 然 这 
样 很 快 ， 但 是 你 会 面 对 之 前 客人 留 下 的 脏 盘 子 和 剩 菜 。 你 也 许 希 望 等 待 服务 员 清 理 
桌子 后 再 坐 下 。 这 与 Buffer 和 原生 类 型 的 工作 方式 很 像 。Buffer 并 不 会 为 了 让 你 
更 方便 而 做 额外 的 工作 ， 但 它们 能 让 你 直接 快速 地 操作 内 存 。 如 果 你 想 要 一 组 漂亮 
的 全 是 0 的 比特 组 ， 就 需要 自己 动手 (或 是 找 找 其 他 工具 库 )。 


当 你 在 处 理 网 络 传输 协议 之 类 的 工作 时 ， 因 为 它们 有 着 定义 好 的 格式 ， 所 以 创建 指 
定 字 节 长 度 的 Buffer 就 很 常用 了 。 当 你 准确 地 知道 数据 的 大 小 (或 者 是 知道 最 大 
会 是 多 少 )， 并 为 了 性 能 原因 想 分 配 并 重用 Buffer 时 ， 这 就 是 很 好 的 选择 。 


也 许 创建 Buffer 最 常用 的 方法 就 是 使 用 ASCII 或 UTF-8 字符 串 了 。 虽 然 Buffer 
可 以 存储 任何 数据 ， 但 在 处 理 IO 的 字符 数据 时 Buffer 特别 有 用 ， 因 为 Buffer 本 
身 的 一 些 限 制 使 得 它 的 操作 比 一 般 的 字符 串 操 作 要 快 很 多 。 所 以 当 你 在 创建 高 度 可 
扩展 的 应 用 时 ， 通 常 值 得 采用 Buffer 来 保存 字符 串 ， 特 别 是 当 你 只 是 在 应 用 间 分 
流 字符 串 ， 而 不 会 修改 它们 的 时 候 。 因此， 即使 JavaScript 原生 存在 了 字符 串 类 型 ， 
在 Node 程序 中 还 是 会 经 常 使 用 Buffer 来 保存 字符 串 。 


如 例 4-24 所 示 的 例子 ， 我 们 用 字符 串 来 创建 Buffer， 它 默认 是 UTF-8 编码 的 。 如 
果 你 没有 指定 编码 格式 ， 它 就 会 认为 是 UTF-8 字符 串 。 这 并 不 意味 着 Buffer 会 
把 字符 串 补 全 成 能 够 存 下 任意 Unicode 字符 的 大 小 (盲目 地 为 每 个 字符 分 配 4 个 字 
节 )， 而 是 说 明 它 不 会 截断 字符 内 容 。 在 这 个 例子 中 ， 我 们 看 到 当 输 入 的 字符 串 是 小 
写字 母 时 ， 无 论 采 用 的 是 哪 种 编码 方式 ，Buffez 都 使 用 同样 的 字 节 结构 ， 因 为 每 
个 字母 都 落 在 同样 的 区 间 里 。 但 是 ， 当 我 们 输入 “6 ”字符 时 ， 无 论 是 默认 的 UTF-8 
还 是 我 们 显 式 指 定 为 UTF-8， 它 都 被 编码 成 2 个 字 市 大 小 。 但 是 当 我 们 指定 编码 为 
ASCII 时 ， 字 符 被 截断 成 单个 字 市 。 


例 4-24 用 字符 串 创 建 Buffer 


> new Buffer('foobarbaz'); 
<Buffer 66 6f 6f 62 61 72 62 61 7a> 
































> new Buffer('foobarbaz', 'ascii'); 
<Buffer 66 6f 6f 62 61 72 62 61 7a> 
> new Buffer('foobarbaz', 'utf8'); 


<Buffer 66 6f 6f 62 61 72 62 61 7a> 
> new Buffer('é'); 
<Buffer c3 a9> 


> new Buffer('é', 'utf8'); 
<Buffer c3 a9> 
> new Buffer('é', 'ascii'); 


<Buffer e9> 





4. 字符 串 的 使 用 


Node 提供 了 一 些 操作 来 简化 字符 串 和 Buffer 操作。 首先 ， 你 不 需要 在 创建 
Buffer 前 提前 计算 字符 串 的 长 度 ， 只 要 把 字符 串 作为 参数 传 给 创建 Buffer 的 函数 
就 可 以 了 。 或 者 ， 你 也 可 以 使 用 Buffer.byteLength () 方法 来 获得 字符 串 在 编码 
上 的 字 节 长 度 ， 而 不 是 string.1length 返回 的 字符 个 数 。 


你 还 可 以 往 已 经 存在 的 Buffer 上 写 入 字符 串 。Buffer.write() 会 把 字符 串 写 到 
Buffer 指定 的 位 置 上 。 如 果 从 Buffer 指定 位 置 开 始 有 足够 空间 的 话 ， 整 个 字符 串 
都 会 被 写 入 。 否 则 ， 字 符 串 的 尾部 会 被 截断 ， 好 让 其 大 小 能 放 入 Buffer。 在 这 两 
种 情况 下 ，Buffer.write() 都 会 返回 一 个 数字 ， 表 示 有 多 少 字 市 被 成 功 写 入 。 对 
于 UTF-8 字符 串 来 说 ， 如 果 一 个 完整 字符 无 法 写 入 到 Buffer 的 话 ， 就 不 会 单独 写 
入 该 字符 的 某 个 字 节 。 如 在 例 4-25 中 ， 因 为 Buffer 大 小 了 ， 以 至 于 无 法 写 入 一 个 
韭 ASCI 字符 ， 所 以 它 就 是 空 的 。 











例 4-25 Buffer.write() 及 部 分 字符 


> var b = new Buffer(1); 
> b 

<Buffer 00> 

> b.write('a'); 
1 

> 革 

<Buffer 61> 

> b.write('é'); 
0 

> b 

<Buffer 61> 


> 


在 只 有 一 个 字 节 的 Buffer 中 ， 它 可 以 写 入 一 个 “a” 字 符 ， 所 以 操作 返回 了 1， 表 
示 写 入 了 1 个 字 市 。 但 是 ， 尝 试 写 入 一 个 “é” 字 符 的 时 候 ， 它 需要 2 个 字 闻 ， 因 此 
操作 返回 的 是 0， 因为 没有 写 入 任何 东西 。 


使 用 Buffer.write() 还 有 些 复杂 的 情况 。 如 果 条 件 人 允许 ， 当 写 入 UTF-8 时 ， 
Buffer.write() 写 和 的 字符 串 会 以 一 个 NULL 字符 结尾 2 这 企 一 个 较 大 的 Buffer 
中 写 入 时 能 够 看 得 更 明显 。 


在 例 4-26 中 ,创建 了 一 个 5 个 字 节 长 的 Buffer (这 是 通过 传 入 字符 串 直接 完成 
的 )。 我 们 用 字母 £ 把 Buffer 整个 写 满 ，f 的 字符 编码 是 ox66 (十 进 制 是 102)。 
这 是 为 了 让 我 们 能 够 看 清楚 ， 在 Buffer 位 移 为 1 的 地 方 写 入 字符 “ab” 会 有 什 
么 效果 。 第 0 位 的 字符 依然 是 E。 在 位 置 1 和 2 上， 字符 被 改 为 了 61 和 62。 然 后 








注 5， 通常 这 只 是 意味 着 是 一 个 二 进 制 的 0。 
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Buffer.write() 插入 了 一 个 结束 符 ， 正 如 例子 中 的 一 个 空 字符 0x00。 
例 4-26 写 入 Buffer 的 字符 串 包 含 了 结束 符 


> Vvar b = new Buffer(5); 
» BB Weite( "ffff£)s 

Ss 

>b 

<Buffer 66 66 66 66 66> 
> b.write('ab', 1); 

2 

> BB 


<Buffer 66 61 62 00 66> 


> 


4.3.4 console.log 

这 个 简单 的 console.1og 命令 借用 了 Firefox 中 Firebug 调试 器 的 概念 ， 让 你 可 以 
轻松 把 输出 打印 到 标准 输出 (stdout) ， 而 不 需要 借助 任何 模块 ( 例 4-27)。 它 还 提 
供 了 美化 打印 格式 的 功能 来 帮助 遍历 对 象 。 


例 4-27 用 console .1og 输出 


3 FO0 二 (5 

{} 

> foobar = function() {1+1}; 
[Function] 

> CONsSOlée.,10g (£00); 

{ bar: [Function] } 

> 
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工具 类 API 





本 章 会 介绍 另 一 组 你 肯定 会 经 常 使 用 的 API， 但 它们 的 使 用 频率 不 如 第 4 章 介 绍 的 
那些 API 高 。 


5.1 DNS 


和 普通 用 户 一 样 ， 程 序 员 一 般 都 希望 用 域名 来 代替 IP 地 址 作为 事物 的 引用 名 称 。 
DNS 模块 就 提供 了 这 种 查找 的 功能 ， 也 为 那些 使 用 域名 的 模块 提供 支持 ， 如 HTTP 
客户 端 。 

DNS 模块 包含 了 两 个 主要 方法 ， 以 及 一 些 便利 的 方法 。 这 两 个 主要 方法 是 
resolve() 和 reverse() ， 前 者 把 域名 转换 成 DNS 记录 ， 后 者 将 IP 地 址 转换 成 域 
名 。DNS 模块 的 其 他 方法 都 是 这 两 种 方法 的 特殊 形式 。 


dns .resolve() 接受 以 下 3 个 参数 。 
待 解析 的 域名 字符 串 


这 可 以 包含 子 域名 ， 如 www.yahoo.com。 其 中 www 是 主机 名 ， 但 系统 也 会 为 你 解 
析 它 。 





表示 请 求 的 记录 类 型 的 字符 囊 
这 需要 你 对 DNS 有 更 多 的 了 解 。 许 多 人 都 熟悉 address 或 A record 类 型 ， 这 种 
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记录 类 型 把 IPv4 区 域 映射 到 一 个 域名 (前 一 个 项 目 定义 的 )。 而 canonical name 
或 CNAME 记录 允许 你 为 A record 或 另外 一 个 CNAME 创建 一 个 别名 ， 如 www. 
example.com 可 能 是 A record 类 型 域名 example.com 的 别名 。MX 记录 指向 使 用 
SMTP 的 邮件 域名 服务 器 。 当 你 发 送 email 到 person@domain.com 时 ，domain.com 
的 MX 记录 会 告诉 你 的 邮件 服务 器 该 把 邮件 发 往 哪里 。Text 记录 ， 或 称 为 TXT， 
是 依附 在 域名 上 的 记录 ， 它 可 以 用 作 各 种 用 途 。DNS 库 支持 的 最 后 一 种 类 型 是 
service， 或 称 为 SRV 记录 ， 它 的 作用 是 在 特定 域名 下 说 明 有 哪些 服务 可 用 。 





回调 函数 
这 是 从 DNS 服务 器 返回 的 响应 内 容 。 函 数 原型 见 例 5-2。 








如 例 5-1 所 示 ， 调 用 ans .resolve() 很 简单 ， 但 它 的 回调 函数 与 你 之 前 看 见 的 3 
他 回调 函数 有 些 不 一 样 。 


4 





例 5-1 调用 qns .resolve() 


dns.resolve('yahoo.com', 'A', function(e,r) { 
if (et{ 
console.1log(e); 


} 


console.1log(r); 
人 
我 们 调用 ans .reslove () 时 指定 了 域名 和 记录 类 型 A， 同 时 还 有 一 个 简略 的 回调 函 
数 把 结果 打印 出 来 。 回 调 函 数 的 第 一 个 参数 是 error 对 象 。 如 果 有 错误 发 生 ， 该 对 
象 就 不 会 是 nul1， 我 们 就 能 通过 它 查 看 到 底 发 生 了 什么 错误 。 第 二 个 参数 是 查询 返 
回 的 结果 列表 。 
还 有 些 方便 的 方法 可 用 来 处 理 前 面 列 出 的 各 种 记录 类 型 。 比 如 ， 除 了 调用 resolve 
('example.com'，'MX'，callback) 以 外 ， 你 还 可 以 调用 resolveMx ( 'example . 


com'， callback)， 见 例 $-2。API 还 提供 了 resolve4() 和 resolve6() 方法 ， 
分 别 用 来 解析 IPv4 和 IPv6 地 址 。 





例 5-2 使 用 resolve() 和 resolveMx () 


var dns = require('dns'); 
dns.resolve('example.com', 'MX', functionl(e, r) { 
EE (EA 


console.1log(e); 


console.1log(r); 


} ys 


dns.resolveMx ('example.com', function(e, r) { 
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i (全 ) 4 
console.log(e); 


} 


console.1og (r); 


3s 


因为 resolve () 通常 会 返回 一 个 包含 许多 IP 地 址 的 列表 ， 所 以 需要 有 dns 模块 ， 
该 模块 提供 了 一 个 便利 的 ans .1ookup () 方法 ， 可 以 从 一 个 A 记录 查询 中 只 返回 一 
个 耳 地 址 〈 例 5-3)。 该 方法 的 参数 是 域名 、 了 P 类 型 (4 或 6) 和 回调 函数 。 但 是 ， 
与 dns.resovle() 不 同 ， 它 永远 只 返回 一 个 地 址 。 如 果 你 没有 传 入 地 址 ， 它 会 默 
认 是 网 络 设备 接口 的 当前 设置 。 





例 5-3 ”用 lookup () 查询 单个 A 记录 


var dns = require('dns'); 


dns.lookup('google.com', 4, functionl(e, a) { 
console.1log(a); 


} os 


5.2 加密 


加 密 在 许多 领域 都 会 用 到 ，Node 的 加 密 算法 是 以 OpenSSL 库 为 基础 的 ， 这 是 因 
为 OpenSSL 的 加 密 算 法 经 过 了 充分 测试 ， 并 且 有 着 良好 的 实现 。 但 你 需要 在 编译 
Node 的 时 候 指 定 添加 OpenSSL 支持 ， 才 能 使 用 本 节 介 绍 的 方法 。 

加 密 模 块 能 帮 你 完成 以 下 工作 。 首 先 ， 它 使 Node 能 够 使 用 SSL/TLS。 其 次 ， 它 包 
含 的 哈 希 算法 ， 如 MD5 或 SHA-1， 也 许 是 你 在 开发 应 用 中 会 用 到 的 。 再 次 ， 它 人 
许 你 使 用 HMAC' ， 其 提供 了 若干 加 密 方法 来 确保 数据 安全 。 最 后 ，HMAC 包含 了 
公 钥 加 密 功 能 来 对 数据 进行 签名 及 验证 。 


加 密 的 每 个 功能 都 包含 在 一 个 或 多 个 类 中 ， 我 们 接 下 来 会 一 一 介绍 。 














5.2.1 Hashing 

哈 希 常用 于 儿 个 重要 的 功能 ， 比 如 把 数据 混淆 以 便于 验证 ， 或 是 为 一 个 较 大 
的 数据 提供 很 小 的 校 验 。 要 在 Node 里 使 用 哈 希 ， 需 要 调用 工厂 方法 crypto. 
createHash() 来 创建 一 个 Hash 对 象 。 它 会 返回 指定 哈 希 算法 的 Hash 新 实例 ， 大 
部 分 流行 的 算法 都 包含 在 内 ， 有 具体 支持 哪 种 算法 要 看 你 安装 的 OpenSSL 的 版 本 ， 几 
个 常见 的 算法 有 : 














注 1: Hash-based Message Authentication Code (HMAC) 是 一 种 验证 数据 的 加 密 算法 。 它 通常 被 用 来 验证 两 
个 数据 是 否 一 致 ， 其 作用 类 似 哈 希 算法 ， 但 也 可 以 用 来 确保 数据 没有 被 自 改 。 
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。 md5 

。 shal 

。 Sha256 

。 Sha512 

。 ripemd160 


这 些 算法 有 各 自 的 优 缺 点 。 比 如 MD5 在 许多 应 用 里 都 会 用 到 ， 但 它 有 一 些 已 
知 的 缺陷 ,包括 碰撞 问题 *。 根 据 实 际 的 应 用 需要 ， 你 可 以 选择 广泛 使 用 的 算法 
(如 MD5)， 或 者 更 新 的 SHAIL (推荐 使 用 )， 其 至 是 更 少见 但 更 健壮 的 算法 (如 
RIPEMD、SHA256 或 SHA512)。 








在 哈 希 中 使 用 数据 时 ， 可 以 调用 hash.update() 来 生成 数据 摘要 (digest， 见 例 
5-4)。 你 可 以 用 更 多 的 数据 不 停 地 更 新 哈 希 ， 直 到 需要 把 它 输出 为 止 。 你 添加 到 哈 
希 对 象 的 数据 只 是 简单 地 追加 到 前 一 次 传人 的 数据 尾部 。 要 把 哈 希 输出 ， 只 需 调 用 
hash.dqigest () 方法 ， 这 会 把 所 有 通过 hash.update() 输入 的 数据 生成 摘要 并 输 
出 。 在 调用 hash.dqigest () 之 后 ， 就 不 可 以 再 添加 任何 输入 进去 了 。 


例 5-4 用 Hash 创建 摘要 


> Var crypto = tedquire ('crypto' ) ; 


> var md5 = crypto.createHash('md5'); 
> md5 .update('foo'); 
{} 


> md5.digest (); 

'-%\u00180LAo\\ 1ieoiAng' 
注意 ， 输 出 的 摘要 看 起 来 有 点 诡异 ， 这 是 因为 它 是 以 二 进 制 的 格式 呈现 的 。 通 常 ， 
摘要 是 用 十 六 进 制 打印 的 ， 我 们 可 以 在 调用 hash .digest 的 时 候 传 入 'hex' 作为 
参数 ， 如 例 5-5 所 示 。 


例 5-5 哈 希 的 生命 周期 和 得 到 十 六 进 制 输 出 





> var md5 = crypto.createHash('md5'); 
> md5 .update('foo'); 
{} 


> md5.digest ()，; 

'-%\u00180LAg\\iieOiAcg' 

> md5.digest ('hex'); 

Error: Not initialized 
at [object Context] :1:5 
at Interface.<anonymous> (repl.js:147:22) 
at Interface.emit (events.js:42:17) 








注 2: 要 想 故意 找 出 两 个 数据 使 得 它们 的 MD5 校 验 一 样 也 是 可 能 的 ， 这 就 使 得 在 某 些 情况 下 这 个 方法 不 太 
合适 。 一 些 更 现代 的 算法 更 加 安全 ， 虽 然 现 在 有 人 也 在 SHA1 上 发 现 了 类 似 的 问题 。 
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at Interface. onLine (readline.js:132:10) 
at Interface. line (readline.js:387:8) 
at Interface. ttyWrite (readline.js:564:14) 
at ReadStream.<anonymous> (readline.js:52:12) 
at ReadStream.emit (events.js:59:20) 
at ReadStream. emitKey (tty posix.js:280:10) 
at ReadStream.onData (tty posix.js:43:12) 

> Var md5 = crypto.createHash('md5'); 

> md5.update('foo'); 


{} 


> md5.digest ('hex'); 
'acbdli8db4cc2f85cedef654fccc4a4d8' 
> 


当 再 次 调用 hash.digest () 时 ， 我 们 得 到 了 一 个 错误 。 这 是 因为 一 旦 调用 hash . 
digest () ，Hash 对 象 就 已 经 最 终 确 定 ， 而 且 不 能 被 重用 。 我 们 需要 创建 一 个 Hash 
的 新 实例 来 使 用 ， 这 次 得 到 的 十 六 进 制 输出 更 为 有 用 。hash.digest () 输入 的 选项 
包括 二 进 制 (默认 )、 十 六 进 制 和 base64 编码 。 


因为 数据 在 hash.update() 调用 时 是 串联 起 来 的 ， 所 以 例 5-6 中 两 个 示例 得 到 的 
结果 是 一 样 的 。 


例 5-6 看 看 hash.update() 是 如 何 把 输入 连接 起 来 的 


> Var Shal = crypto.createHash('shal'); 
> shal.update('foo'); 


shal.update('bar'); 


shal.digest ('hex'); 
843d7f9241621llde9ebb963ff4ce28125932878' 
var shal = crypto.createHash('shal'); 
shal.update('foobar'); 


} 


> shal.digest ('hex'); 
'8843d7f9241621lde9ebb963ff4ce28125932878' 


Ed 


虽然 hash.update() 看 起 来 和 流 模式 很 像 ， 但 要 注意 的 是 ， 其 实 它 并 不 是 流 。 你 
可 以 很 容易 地 把 一 个 流连 接 到 nash.update () 上 ,但 是 不 能 使 用 stream.pipe() 
方法 。 





5.2.2 HMAC 

HMAC 结合 了 哈 希 算法 和 加 密 密 钥 ， 是 为 了 阻止 对 签名 完整 性 的 一 些 恶意 攻击 。 这 
意味 着 HMAC 同时 使 用 了 哈 希 算法 〈 如 上 一 小 节 所 介绍 的 一 些 算法 ) 以 及 一 个 加 密 
密 钥 。Node 提供 的 HMAC API 和 Hash API 是 一 样 的 。 唯 一 的 不 同 是 ， 创 建 hmac 
对 象 时 需要 在 传人 哈 希 算法 的 同时 ， 再 传 入 一 个 密 钥 。 

















crypto.createHmac() 返回 的 是 一 个 Hnac 的 实例 提供 了 update() 和 
digest () 方法 ， 这 些 和 之 前 我 们 介绍 的 Hash 方法 一 模 一 样 。 
创建 Hmac 对 象 需 要 的 密 钥 必 须 是 一 个 PEM 编码 的 密 钥 ， 以 字符 串 的 格式 传人。 如 
例 5-7 所 示 ， 在 命令 行 用 OpenSSL 可 以 轻松 创建 一 个 密 钥 。 
例 5-7 创建 PEM 编码 的 密 钥 

Enki:~ $ openssl genrsa -out key.pem 1024 


Generating RSA private key, 1024 bit long modulus 
十 十 十 十 十 十 





i 十 十 十 十 十 十 
e is 65537 (0x10001) 
Enki:~ $ 


这 个 例子 创建 的 是 一 个 PEM 格式 的 RSA 密 钥 ， 并 保存 在 一 个 文件 里 (在 本 例 中 是 
key .pem)。 如 果 我 们 忽略 -out key .pem 参数 ， 也 可 以 在 Node 中 使 用 process 
模块 来 直接 调用 同样 的 功能 (本章 后 面 会 介绍 到 )。 用 这 个 方法 ， 我 们 将 在 标准 输出 
中 得 到 结果 ， 否 则 ， 就 需要 从 文件 中 读 取 密 钥 ， 然 后 再 用 来 创建 Hmac 对 象 并 生成 
摘要 了 ( 例 5-8)。 


例 5-8 创建 Hmac 摘要 


var crypto = require('crypto'); 
var fs = require('fs'); 


var pem 
var key 


fs.readFileSync('key.pem'); 
pem.toSstring('ascii'); 


Var hmac = crypto.createHmac('shal', key); 


2 
水 
a 
> 
> 
4 
2 
> hmac.update('foo'); 
{ 


} 
> hmac.digest ('hex'); 
1'TbO58f2f33ca28da3ff3c6506c978825718c7d42' 


这 个 例子 用 到 了 fs.readFilesync ()， 因 为 在 许多 情况 下 ， 读 取 密 钥 会 放 在 服务 器 
启动 任务 中 。 这 个 时 候 ， 我 们 可 以 用 同步 的 方式 来 读 取 密 钥 (但 会 使 服务 器 启动 时 间 
稍微 变 长 )。 因 为 你 还 没 开始 服务 任何 客户 ， 所 以 把 事件 循环 堵塞 一 会 儿 并 没有 什么 
问题 。 一 般 情 况 下 ， 除 了 使 用 加 密 密 钥 外 ， 使 用 Hmac 与 使 用 Hash 的 例子 是 一 样 的 。 


5.2.3 公 钥 加 密 
公 钥 加 密 功能 分 布 在 如 下 4 个 类 中 : cipher、Decipher、Sign 和 Verify。 和 加 
密 模块 的 其 他 类 一 样 ， 它 们 也 有 工厂 方法 。cipher 把 数据 加 密 ，Decipher 解密 数 
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据 ，sign 为 数据 创建 加 密 签名 ，verify 验证 加 密 签名 。 


对 HMAC 操作 ,我 们 用 到 了 私 钥 。 对 于 本 小 节 的 操作 ， 我 们 将 同时 使 用 公 钥 和 私 
钥 。 公 钥 加 密 算法 需要 一 组 配对 的 密 钥 : 一 个 是 私 钥 ， 由 物 主 保存 ， 用 来 解密 和 对 
数据 签名 ， 另 外 一 个 是 公 钥 ， 提 供给 第 三 方 。 公 钥 可 以 用 来 加 密 数据 ， 并 且 只 能 让 
私 钥 拥 有 者 解读 ， 或 者 用 来 验证 数据 是 否 被 对 应 的 私 钥 所 签名 。 


让 我 们 从 刚刚 生成 来 进行 HMAC 摘要 的 私 钥 中 提取 对 应 的 公 钥 吧 ( 例 5-9)。Node 
要 求 公 钥 按照 证 书 格 式 ， 所 以 需要 你 提供 额外 的 信息 ， 但 你 也 可 以 不 填 这 些 信息 ， 
让 其 留 空 就 行 了 。 


例 5-9 ”从 私 钥 中 提取 公 钼 证 书 


Enki:~ $ openssl req -key key.pem -Dew -x509 -out cert.pem 

You are about to be asked to enter information that will be incorporated 
into your certificate request. 

What you are about to enter is what is called a Distinguished Name or a DN. 
There are quite a few fields but you can leave some blank 

For some fields there will be a default value, 

If you enter '.', the field will be left blank. 





Country Name (2 letter code) [AU] : 

State or Province Name (full name) [Some-Statel]: 

Locality Name (eg, city) [] : 

Organization Name (eg, company) [Internet Widgets Pty Ltd] : 
Organizational Unit Name (eg, section) []: 

Common Name (eg, YOUR name) []: 

Email Address []: 

Enki:~ $ ls cert.pem 

Gert :pem 

Enki:~ $ 


我 们 让 OpenSSL 读 取 私 钥 ， 然 后 把 公 钥 以 X509 证 书 格式 输出 到 cert.pem 文件 中 。 
加 密 算 法 用 到 的 密 钥 都 要 求 是 PEM 格式 的 。 





1. 用 Cipher 加 密 


Cipher 类 提供 了 用 私 钥 加 密 数 据 的 功能 。 该 工厂 方 法 输入 一 个 算法 和 私 钥 ， 然 后 
创建 cipher 对 象 。 支 持 的 算法 是 从 你 安装 的 OpenSSL 实现 中 支持 的 : 





。 pblowfish 


。 aeS192 

许多 现代 的 加 密 算 法 使 用 块 密码 ， 也 就 是 输出 的 通常 是 标准 大 小 的 “ 块 "。 块 大 小 与 
使 用 的 算法 有 关 ， 如 blowfish 使 用 的 是 40 字 节 的 块 。 这 当 你 使 用 cipher API 时 
会 明显 看 出 ， 因 为 API 总 是 使 用 固定 大 小 的 块 。 这 种 做 法 能 够 防止 信息 泄露 给 攻击 
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者 ， 如 加 密 的 信息 或 者 是 用 来 加 密 的 特定 密 钥 


和 Hash、Hmac 类 似 ，cipher API 也 采用 update () 方法 来 输入 数据 ， 但 是 在 使 用 
cipher 时 upaate () 的 工作 方式 不 一 样 。 首 先 ， 如 果 条 件 人 允许，cipher.update () 
会 返回 一 块 加 密 的 数据 。 这 时 候 数 据 块 的 大 小 变 得 很 重要 ， 如 果 cipher 中 的 数据 加 
上 传 给 cipher .update() 的 数据 足够 用 来 创建 一 个 或 多 个 加 密 块 ， 那 么 这 些 加 密 
数据 就 会 被 返回 。 如 果 数 据 不 足以 构成 一 个 加 密 块 ， 输 入 会 被 保存 在 cipher 对 象 
内 。cipher 还 有 一 个 新 的 方法 cipher.final() ， 它 会 代替 aigest () 方法 。 当 调 
用 cipher.final() 时 , cipher 对 象 中 剩余 的 所 有 数据 都 会 被 加 密 并 返回 , 但 会 添 
加 足够 的 填充 使 其 满足 块 大 小 的 要 求 ( 例 5-10)。 


例 5-10 ”密码 与 块 大 小 





Var crypto = require('crypto'); 
Va £8 := Eedulee( "Ee ); 


Ea 

- 

> Var pem = fs.readFileSync('key.pem'); 
> var key = pem.toSstring('ascii'); 
Es 
Ee 
> 


var cipher = crypto.createCipher('blowfish', key); 


cipher.update (new Buffer(4), 'binary', 'hex'); 
和 
> cipher.update (new Buffer(4), 'binary', 'hex'); 
'ff57esSf742689c85' 


> cipher.update (new Buffer(4), 'binary', 'hex'); 
Li 


> cipher.final('hex') 
'96576b47fel30547' 


区 


为 了 让 例子 易于 阅读 ， 我 们 指定 了 输入 输出 格式 。 输 入 输出 格式 都 是 可 选 的 ， 如 
果 没 有 指定 ， 将 默认 按 二 进 制 处 理 。 这 个 例子 中 ， 我 们 指定 了 输入 格式 为 二 进 制 ， 
因为 传人 了 一 个 新 的 Buffer 对 象 (包含 了 内 容 已 有 的 垃圾 数据 )。 ， 
输出 格式 为 十 六 进 制 ， 这 是 为 了 让 产生 的 内 容 更 容易 读 。 你 可 以 看 到 ， 和 
用 cipher.upaate() 时 传人 了 4 个 字 节 的 数据 ， 得 到 的 是 一 se 

次 ， 因 为 有 足够 的 数据 来 生成 加 密 块 ， 我 们 得 到 了 十 六 进 制 格式 的 加 密 数据 。 
用 cipher.final() 时 ， 因 为 数据 并 不 够 用 来 创建 一 个 完整 的 加 密 块 ， 所 以 输出 被 
填补 成 一 个 完整 (最终) 块 并 返回 。 如 果 我 们 发 送 的 数据 超过 一 个 块 所 需要 的 大 
小 , cipher.final() 会 先 返 回 尽 可 能 多 的 加 密 块 , 然后 才 会 采用 补 全 的 方法 。 因 为 
cipher.final () 只 是 用 来 把 已 有 的 数据 输出 ， 所 以 它 并 不 接受 新 的 输入 内 容 。 


2. 用 Decipher 解密 
Decipher 类 几乎 就 是 cipher 类 的 反面 。 你 可 以 把 加 密 的 数据 通过 decipher. 
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updaate() 传 给 一 个 Decipher 对 人 象 ， 它 会 把 数据 以 流 的 形式 保存 成 块 ， 并 在 数 
据 足 够 的 时 候 输 出 解密 数据 。 你 也 许 会 想 ， 因 为 cipher.update() 和 cipher. 
final() 总 是 输出 固定 大 小 的 数据 块 ， 你 也 不 得 不 给 Decipher 精确 大 小 的 内 容 。 
但 幸运 的 是 ， 它 会 缓存 数据 。 而 且 ， 你 还 可 以 用 其 他 IO 传输 方式 来 传 给 它 数据 ， 
如 磁盘 和 网 络 ， 即 使 这 些 方法 给 你 的 数据 大 小 与 加 密 算法 使 用 的 不 一 样 。 


让 我 们 看 一 下 例 5-11， 本 例 演 示 了 如 何 加 密 数据 并 解密 它 。 
例 5-11 文本 加 密 与 解密 








var crypto = require('crypto'); 
Var fs = require('fs'); 
Var pem fs.readFileSync('key.pem'); 


var key pem.toString('ascii'),; 

var plaintext = new Buffer('abcdefghijklmnopqrstuv'); 
Var encrypted = ""; 

var cipher = crypto.createCipher('blowfish', key); 


encrypted += cipher.update(plaintext, 'binary', 'hex'); 
encrypted += cipher.final('hex'); 


Var decrypted = ""; 

var decipher = crypto.createDecipher('blowfish', key); 
decrypted += decipher.update (encrypted, 'hex', 'binary'); 
decrypted += decipher.final('binary'); 


VV VV VV VV VV VV VV VV VV VVV 


var output = new Buffer(decrypted); 

> output 

<Buffer 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72 73 74 75 76> 
> plaintext 

<Buffer 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72 73 74 75 76> 
> 


重要 的 是 要 确保 输入 输出 的 格式 在 纯 文本 和 加 密 数 据 上 是 一 致 的 。 还 要 注意 的 是 ， 
为 了 得 到 一 个 Buffer 对 象 ， 你 需要 用 cipher 和 Decipher 返回 的 字符 串 来 构建 。 


3. 用 Sign 来 创建 签名 


Signatures 验证 的 是 签名 者 是 否 用 其 私 钥 对 数据 进行 授权 。 但 是 ， 和 HMAC 不 同 ， 
公 钥 可 以 用 来 对 签名 进行 认证 。sign 类 的 API 与 HMAC 的 几乎 一 样 ( 见 例 5-12)。 

crypto.createSign() 用 来 创建 sign 对 象 ; createsign () ) 只 需要 传 入 签名 算 
法 ; sign.update() 可 给 sign 对 象 添加 数据 。 想 创建 签名 时 ， 可 以 用 你 的 私 钥 来 
调用 sign.sign() 给 数据 进行 签名 。 

















例 5-12 用 sign 对 数据 进行 签名 


> Var sign = crypto.createSign('RSA-SHA256'); 
> sign.update('abcdef'); 


{} 

> sig = sign.sign(key, 'hex'); 
'35eb47af5260a00c7bad26edfbe7732a897a3a03290963e3d17f48331a42...aa81b' 
> 


4. 用 Verify 来 验证 签名 


Verify API 使 用 的 方法 和 我 们 刚刚 讨论 的 类 似 ( 见 例 5-13)， 它 用 verify. 
update() 来 添加 数据 ， 且 当 你 把 需要 验证 的 数据 都 添加 好 后 ， 就 可 以 调用 
verify.verify() 对 签名 进行 验证 了 ， 它 需要 传 入 证 书 ( 公 钥 )、 签 名 以 及 签名 的 
格式 。 


例 5-13 验证 签名 


var crypto = require('crypto'); 
var fs. ss Fequire("fs"); 


Var privatePem = fs.readFileSync('key.pem'); 
Var publicPem = fs.readFileSync('cert.pem'); 
var key = privatePem.toString(); 

var pubkey = publicpPem.toString(); 


var data = "abcdef" 


Var sign = crypto.createSign('RSA-SHA256'); 
sign.update (data); 


VV VV VV VV VVVV 


{} 

> var sig = sign.sign(key, 'hex'); 

> Var verify = crypto.createVerify('RSA-SHA256'); 
> verify.update (data),; 


{} 
> verify.verify(pubkey, sig, 'hex'); 
1 


5.3 ”进程 


虽然 Node 把 许多 东西 从 操作 系统 中 抽象 出 来 ， 但 你 依然 在 操作 系统 里 运行 ， 而 且 
可 能 想 要 更 直接 地 与 它 交 互 。Node 中 可 以 使 用 系统 中 已 经 存在 的 进程 ， 或 者 创建 新 
的 子 进程 来 做 各 种 工作 。 虽 然 Node 本 身 是 一 个 “ 胖 ” 线 程 ， 带 有 单独 一 个 事件 循 
环 ， 但 你 可 以 任意 地 开启 其 他 进程 〈 线 程 ) 在 事件 循环 外 工作 。 











5.3.1 Process 模 块 

可 以 使 用 process 模块 从 当前 的 Node 进程 中 获得 信息 ， 并 可 以 修改 配置 。 和 其 他 

大 部 分 模块 不 同 ，process 模块 是 全 局 的 ， 并 且 可 以 一 直通 过 变量 process 获得 。 

1. process 事件 

process 是 EventEmitter 的 实例 ， 所 以 它 提 供 了 基于 对 Node 进程 的 系统 调用 的 

事件 。exit 事件 提供 了 在 Node 进程 退出 前 的 最 终 响 应 时 机 ( 例 5-14)。 重 要 的 是 ， 

事件 循环 在 exit 事件 之 后 就 不 会 再 运行 了 ， 因 此 只 有 那些 不 需要 回调 函数 的 代码 
会 被 执行 。 


例 5-14 在 Node 退出 前 调用 代码 











process.on('exit', function () { 
setTimeout (function () { 
console.log('This will not run'); 
}, 100); 


console.log('Bye.'); 


}); 
因为 事件 循环 不 会 再 运行 ， 因 此 setTimeout () 里 的 代码 永远 不 会 执行 。 


process 提供 的 一 个 非常 有 用 的 事件 是 uncaughtException ( 例 5-15)。 用 过 
Node 一 段 时 间 后 ， 你 会 发 现 那些 在 事件 主 循 环 里 碰 到 的 异常 会 导致 Node 进程 退 
出 。 在 许多 应 用 场景 下 ， 特 别 是 对 那些 希望 永 不 当 机 的 服务 器 程序 来 说 ， 这 都 是 不 
可 接受 的 。uncaughtException 事件 会 提供 一 个 极其 暴力 的 方法 来 捕获 这 些 异常 。 
它 确实 是 最 后 一 道 防线 了 ， 但 对 解决 此 问题 非常 有 效 。 


























例 5-15 通过 uncaughtException 事件 捕获 异常 


process.on('uncaughtException', function (err) { 
console.log('Caught exception: ' + err); 


] ) ; 


setTimeout (function () { 
console.log('This will still run.'); 
}, 500); 


// 故意 导致 异常 ， 并 且 不 捕获 它 。 
nonexistentFunc(); 
console.log('This will not run.'); 


让 我 们 来 分 解 一 下 整个 操作 过 程 。 首 先 ， 我 们 为 uncaughtException 创建 了 一 个 
事件 监听 器 。 它 并 非 一 个 智能 处 理 程序 ， 只 是 简单 地 把 异常 输出 到 标准 输出 。 如 
果 这 个 Node 脚本 是 作为 服务 器 运行 的 话 ， 可 以 很 方便 地 把 标准 输出 保存 到 一 个 
文件 中 ， 记 录 下 这 些 错 误 。 但 是 ， 因 为 它 捕获 的 是 一 个 不 存在 的 函数 触发 的 事件 ， 
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所 以 虽然 Node 程序 不 会 退出 ， 但 是 标准 的 执行 流程 会 被 打 断 。 我 们 知道 所 有 的 
JavaScript 都 会 执行 一 遍 ， 然 后 任何 回调 函数 都 可 能 在 其 对 应 监听 的 事件 触发 时 被 
调用 到 。 但 在 这 个 例子 中 ， 因 为 nonexistentFunc() 抛 出 了 异常 ， 所 以 在 它 之 后 
的 代码 都 不 会 执行 下 去 。 然 而 ， 在 此 之 前 已 经 运行 的 代码 会 继续 下 去 ， 也 就 是 说 ， 
setTimeout () 依然 会 被 调用 。 这 在 你 开发 服务 器 程序 的 时 候 很 重要 。 让 我 们 再 多 
看 些 这 方面 的 例子 〈 例 5-16) 。 


例 5-16 捕获 异常 的 回调 函数 的 作用 


Var http = require('http'); 

var server = http.createServer (function(reqg,res) { 
res.writeHead(200, {}); 
res.end('response'); 
badLoggingCall('sent response'); 
console.log('sent response'); 


}: 





process.on('uncaughtException', function(e) { 
console.log(e); 


})s 


server.listen(8080); 


这 段 代 码 创 建 了 一 个 简单 的 HTTP 服务器， 然后 在 进程 层次 上 监听 所 有 的 未 捕获 异 
常 。 在 HTTP 服务 器 中 ， 回 调 函 数 在 发 送 了 HTTP 响应 后 ， 故 意 调用 了 一 个 错误 的 
函数 。 例 5-17 展示 了 这 个 脚本 的 终端 输出 内 容 。 


例 5-17 例 6-16 的 输出 


Enki:~ $ node ex-test.js 

{ stack: [Getter/Setter], 
arguments: [ 'badLoggingCall' 
type: 'not defined', 

message: [Getter/Setter] } 
stack: [Getter/Setter], 
arguments: [ 'badLoggingCall' 
type: 'not defined', 

message: [Getter/Setter] } 
stack: [Getter/Setter], 
arguments: [ 'badLoggingCall' 
type: 'not defined', 

message: [Getter/Setter] } 
stack: [Getter/Setter], 
arguments: [ 'badLoggingCall' 
type: 'not defined', 

message: [Getter/Setter] } 


当 启 动 这 个 例子 的 脚本 时 ， 服 务 器 已 经 准备 就 绕 ， 然 后 我 们 对 它 发 起 了 儿 次 HTTP 
请 求 。 注 意 ， 服 务 器 并 没有 关闭 退出 。 相 反 ， 错 误 被 绑 定 在 uncaughtException 


一 一 


一 一 


一 一 
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事件 上 的 函数 记录 了 下 来 ， 而 且 我 们 依然 能 够 提供 完整 的 HTTP 请 求 处 理 服务 。 
这 是 为 什么 呢 ? Node 故意 阻止 了 正在 运行 的 回调 函数 继续 处 理 和 调用 下 面 的 
console.1og() 。 该 错误 只 会 影响 我 们 派生 出 来 的 进程 ， 而 服务 器 能 够 继续 运行 ， 
所 以 该 异常 被 封装 在 一 个 特定 的 代码 路 径 上 ， 其 他 代码 并 不 会 受 影响 。 
还 要 重点 理解 的 是 Node 中 的 监听 器 是 如 何 实现 的 ， 让 我 们 看 看 例 5-18。 


例 5-18 EventEmitter 的 简略 监听 代码 


EventEmitter.prototype.emit = function(type) { 











Var handler = this. events[typel]; 


} else if (isArray (handler)) { 
Var args = Array.prototype.slice.call(arguments, 1); 


Var listeners = handler.slice(); 
for (var i = 0, 1 = listeners.length; i < 1; I++) { 
listeners[i] .apply (this, args); 


} 


return true; 


}s 


在 事件 触发 后 ， 运 行 时 处 理 程序 中 的 一 项 检查 是 看 看 是 否 存在 事件 监听 器 的 数组 。 
如 果 有 几 个 监听 器 ， 运 行 执 行 器 会 按 数组 顺序 把 里 面 的 监听 器 一 一 调用 。 意 思 是 说 ， 
第 一 个 绑 定 的 监听 器 会 首先 用 apply() 方法 调用 ， 然 后 是 第 二 个 ， 以 此 类 推 。 这 里 
需要 重点 注意 的 是 ， 同 一 个 事件 的 所 有 监听 器 是 在 同一 个 代码 路 径 上 的 。 所 以 如 果 
其 中 一 个 回调 国 数 出 现 了 异常 未 被 捕获 ， 将 导致 该 事件 的 其 他 回调 国 数 终止 执行 。 
但 是 一 个 事件 实例 中 的 未 捕获 异常 不 会 影响 其 他 事件 。 


我 们 还 能 利用 process 来 访问 一 些 系统 事件 。 当 进程 得 到 一 个 信号 的 时 候 ， 它 会 
通过 process 触发 的 事件 通知 Node 程序 。 例 如 操作 系统 会 产生 许多 POSIX 系 
统 事件 ， 如 sigaction(2) 帮助 文档 中 介绍 的 那些 。 最 常见 的 有 SIGINT、 中 断 信号 
量 。 通 常 ， 当 用 户 对 运行 在 终端 的 程序 按 下 Ctrl-C 的 时 候 ，SIGINT 就 会 发 生 。 除 
韭 你 通过 process 来 处 理 信 号 事件 ， 否 则 Node 会 采取 默认 方法 进行 处 理 。 比 如 说 
SIGINT 的 情况 ， 默 认 操 作 就 是 立刻 杀 死 进程 。 你 可 以 通过 process.on() 方法 来 
修改 这 些 默 认 行为 ， 除 了 一 些 永 远 无 法 捕获 的 信号 之 外 ( 例 5-19)。 




































































例 5-19 捕捉 Node 进程 的 信号 量 
// 开始 从 标准 输入 读 取 内 容 ， 所 以 程序 不 会 退出 


process.stdin.resume(); 





process.on('SIGINT', function () { 
console.log('Got SIGINT. Press Control-D to exit.'); 


})s 


为 了 确保 Node 程序 不 会 主动 退出 ， 我 们 从 标准 输入 读 取 内 容 ( 详 见 下 面 第 三 小 节 
的 内 容 )， 这 样 Node 进程 就 会 继续 运行 了 。 如 果 你 在 程序 运行 的 时 候 按 下 Ctrl-C， 
操作 系统 会 发 送 SIGINT 信号 给 Node 程序 ， 这 会 被 SIGINT 事件 处 理 器 所 捕获 。 在 
本 例 中 ， 我 们 采用 把 信息 记录 在 终端 的 方式 来 代替 原本 的 退出 程序 操作 。 























2. 与 当前 Node 进程 交互 

process 包含 了 有 关 Node 进程 的 许多 元 信息 。 当 你 希望 在 进程 内 管理 Node 运行 环 
境 时 ， 这 会 很 有 用 。 这 里 面包 含 了 关于 Node 进程 的 若干 不 可 改变 (只 读 ) 的 信息 ， 
例如 : 


。 process.version 


。 包含 了 正在 运行 的 Node 的 版 本 号 : 





。 process.installPrefix 
。 也 包含 了 安装 时 指定 的 安装 目录 (/usr/local、~/local 等 ): 


。 process.platform 
。 会 列 出 正在 运行 的 平台 名 称 。 输 出 内 容 会 指明 内 核 (1inux2、darwin 等 )， 而 
不 是 Redhat ES3、Windows 7、OSX 10.7 这 一 类 名 称 。 


。 process.uptime() 


。 还 会 列 出 当前 进程 运行 了 多 少 秒 。 


此 外 ， 你 还 可 以 从 Node 进程 得 到 或 设置 一 些 属 性 。 当 进程 运行 时 ， 它 是 按 某 个 特 
定 的 用 户 及 用 户 组 启动 的 。 你 可 以 调用 process.getgid()、 process.setgid().、 
process.getuid() 和 process.setuid() 来 获得 或 修改 这 些 属性 。 这 样 做 可 以 有 
效 地 确保 Node 程序 运行 在 一 个 安全 的 环境 中 。 还 需要 注意 的 是 ，set 方法 除了 可 
以 接受 用 户 名 /用户 组 所 对 应 的 数字 ID 外 ， 还 可 以 直接 使 用 用 户 组 / 用户 名 本 身 。 
但 是 ， 如 果 你 传 入 的 是 用 户 组 或 用 户 名 ,该 方法 会 采取 堵塞 的 方式 来 把 这 个 信息 翻 
译 成 ID， 这 样 会 花费 些 时 间 。 








正在 运行 的 Node 实例 的 进程 ID ， 或 称 为 PED， 可 以 通过 process.pid 属性 得 到 。 
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你 还 能 修改 process .title 属性 来 设置 Node 显示 在 系统 的 标题 名 称 ， 该 属性 修改 
后 的 内 容 会 在 ps 命令 调用 时 显示 出 来 。 当 你 在 生产 环境 中 需要 运行 多 个 Node 进程 
时 ， 这 会 很 有 用 。 你 可 以 为 每 个 进程 修改 容易 辨别 的 名 称 ， 而 不 是 一 堆 进 程 都 叫做 
node (或 者 node app.js)。 当 一 个 进程 占用 了 大 量 的 CPU 或 RAM 时 ， 也 可 以 很 
快 地 知道 具体 是 谁 干 的 。 


其 他 可 用 的 信息 包括 brocess .execPath， 它 显示 的 是 当前 执行 的 node 程序 所 在 
的 路 径 ， 比 如 /usr/local/bin/node。 当 前 的 工作 目录 (所 有 打开 文件 的 相对 路 径 ) 可 
以 用 process.cwd() 获取 。 工 作 目 录 是 Node 启动 的 目录 。 你 可 以 调用 process . 
chdir() 来 修改 (如 果 修 改 的 目录 不 可 读 或 者 不 存在 ， 将 会 抛 出 异常 )， 还 可 以 使 
用 process .memoryUsage () 来 得 到 当前 进程 的 内 存 使 用 情况 ， 这 会 返回 一 个 对 象 
来 说 明 内 存 使 用 的 各 种 情况 : rss 是 RAM 的 使 用 量 ， 而 vsize 是 内 存 使 用 总 量 ， 
包括 了 RAM 和 swap。 你 还 可 以 获知 V8 的 一 些 状 态 : heapTotal 和 heapUsed 分 
别 表示 V8 分 配 了 多 少 内 存 ， 已 经 有 多 少 内 存 正在 使 用 。 


3. 操作 系统 的 输入 / 输出 


通过 process， 还 有 若干 方法 可 以 与 操作 系统 交互 (除了 修改 正在 运行 的 Node 进 
程 以 外 )。 甚 中 一 个 主要 功能 就 是 可 以 访问 操作 系统 的 标准 IO 流 ，stdin 是 进程 的 默 
认输 入 流 ，stdout 是 进程 的 输出 流 ，stderr 是 其 错误 输出 流 。 它 们 对 应 暴露 的 接口 是 
process.stdin、 process.stdout 和 process.stderr, 其 中 process.stdin 是 
可 读 的 数据 流 ， 而 process.stdout 和 process.stderr 是 可 写 的 数据 流 。 


(1) process.stdin stdin 在 进程 间 通 信 时 是 非常 有 用 的 ， 它 能 够 为 命令 行 下 采用 管 
道 通信 提供 便利 。 当 我 们 输入 cat file.txt | node program.js 时 ,标准 输入 
流 会 接收 到 cat 命令 输出 的 数据 。 


因为 任何 时 候 都 能 使 用 process， 所 以 process.stdin 也 会 为 所 有 的 Node 进程 
初始 化 。 但 它 一 开始 是 处 于 暂停 状态 ， 这 时 候 Node 可 以 对 它 进行 写 入 操作 ， 但 是 
你 不 能 从 它 读 取 内 容 。 在 尝试 从 stdin 读数 据 之 前 ， 需 要 先 调用 它 的 resume () 方法 
( 见 例 5-20)。Node 会 为 此 数据 流 填 入 供 读 取 的 缓存 ， 并 等 待 你 的 处 理 ， 这 样 可 以 
避免 数据 丢失 。 


例 5-20 ”把 标准 输入 写 到 标准 输出 


process.stdin.resume () ; 
process.stdin.setEncoding('utf8'); 



































process.stdin.on('data', function (chunk) { 
process.stdout.write('data: ' + chunk); 


} 








process.stdin.on('end', function () { 
process.stdout .write('end'); 

ys 
我 们 请 求 process.stdin 进行 resume () 操作 ， 并 把 编码 设置 为 UTF-8， 然 后 设 
置 了 监听 器 把 接收 的 数据 推送 到 process.stdout 上 去 。 当 process.stdin 发 起 
end 事件 时 ， 我 们 把 它 也 传输 给 process .stdout 流 。 因 为 stdin 和 stdout 都 是 真 
正 的 数据 流 ， 所 以 我 们 也 可 以 采用 更 简便 的 方法 ， 那 就 是 使 用 数据 流 的 pipe () 方 
法 , 如 例 5-21 所 示 。 


例 5-21 通过 管道 把 标准 输入 转 到 标准 输出 


process.stdin.resume () ; 
process.stdin.pipe (process.stdout); 


这 是 连接 两 个 数据 流 的 最 漂亮 的 方式 。 


(2) process.stderr stderr 用 来 输出 异常 和 程序 运行 过 程 中 遇 到 的 问题 。 在 POSIX 系 
统 里 ， 因 为 它 是 另外 一 个 独立 的 流 ， 所 以 输出 的 日 志和 错误 的 日 志 很 容易 被 记录 到 
不 同 的 目标 位 置 。 这 也 许 是 可 取 的 , 但 Node 有 自己 的 一 套 处 理 特性 。 当 写 入 stderr 
时 ，Node 将 保证 该 次 写 入 的 会 被 完成 。 但 是 ， 和 其 他 普通 的 流 不 一 样 ， 这 会 以 塔 
塞 的 方式 执行 。 通 常情 况 下 ， 调 用 stream.write() 会 返回 一 个 布尔 值 ， 用 来 表示 
Node 是 否 能 够 写 到 内 核 缓 存 中 去 。 对 于 process .stderr 来 说 这 个 返回 值 永远 是 
真 ， 但 它 可 能 不 会 像 一 般 的 wzite() 那样 立刻 返回 ， 而 是 需要 等 待 一 会 儿 。 一 般 来 
说 ， 这 是 非常 快 的 ， 但 内 核 缓存 有 的 时 候 可 能 满 了 ， 这 就 会 导致 你 的 程序 挂 起 等 待 。 
因此 ， 在 一 个 生产 系统 中 ， 我 们 应 该 避免 对 stderr 写 和 人 过 多 的 内 容 ， 因 为 它 会 堵塞 
真正 需要 的 工作 。 


























还 需要 广 意 的 是 ，process .stderr 永远 是 UTF-8 编码 的 数据 流 。 不 需要 设置 编码 
格式 ， 你 写 入 process .stdaexrtz 的 所 有 数据 都 会 被 当做 UTF-8 来 处 理 。 而 且 ， 你 不 
能 更 改编 码 格式 。 

另外 ，Node 程序 员 要 从 操作 系统 读 取 的 内 容 还 包括 了 程序 启动 时 的 参数 。argv 是 
包含 命令 行 参 数 的 数组 ，[ node 命令 为 第 一 个 参数 〈 例 5-22 和 例 5-23)。 

例 5-22 输出 argv 的 简单 脚本 


console.log(process.argv); 





例 5-23 运行 例 5-22 
Enki:~ $ node argv.js -t 3 -c "abc def" -erf foo.js 
[ 'node', 
'/Users/croucher/argv.js', 
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rat 

ES 

-CI， 

'abc def', 

'-erf', 

rf06.j8" ] 
Enki:~ $ 


这 里 需要 注意 几 个 问题 。 第 一 ，process .argv 数组 只 是 简单 地 把 命令 行内 容 以 空 
格 作 分 割 得 到 的 。 如 果 两 个 参数 之 间 包 含 多 个 空格 ， 也 只 会 被 切 分 一 次 。 检 查 空 格 
的 方法 可 以 用 正则 表达 式 (regex) 的 写法 \s+， 但 这 不 包括 引号 内 的 空格 ， 引 号 可 
以 用 来 把 多 个 词组 合 在 一 起 。 而 且 ， 还 要 注意 第 一 个 文件 参数 是 如 何 被 展开 成 全 路 
径 的 。 这 意味 着 你 可 以 传 给 命令 行 一 个 相对 路 径 的 文件 名 作为 参数 ， 它 会 在 argv 
中 显示 成 绝对 路 径 。 这 对 一 些 特 殊 字 符 也 同样 生效 ， 比 如 用 ~ 来 表示 home 目录 ， 
只 有 第 一 个 参数 会 被 这 样 展 开 。 


argv 在 编写 命令 行 脚本 的 时 候 相 当 有 用 ， 但 又 有 点 太原 始 了 。 有 几 个 社区 项 目 对 它 
进行 了 扩展 ， 可 以 帮助 你 轻松 编写 命令 行程 序 ， 包 括 功 能 自动 启用 、 编 写 程序 内 帮 
助 文档 及 其 他 高 级 功能 。 


4. 事件 循环 和 计数 器 


如 果 你 之 前 在 浏览 器 里 使 用 过 JavaScript 编程 ， 就 应 该 对 setTimeout () 很 熟悉 了 。 
在 Node 里 ,我 们 有 更 加 直接 的 方法 来 访问 事件 循环 ， 并 且 可 以 推 延 工作 ， 这 些 非 
常 有 用 。process .nextTick() 创建 了 一 个 回调 函数 ， 它 会 在 下 一 个 tick 或 者 事件 
循环 下 一 次 迭代 时 被 调用 。 因 为 实现 是 使 用 队列 的 ， 所 以 它 会 取代 其 他 事件 。 让 我 
们 在 例 5-24 中 进一步 查看 。 


例 5-24 用 process.nextTick() 往事 件 循 环 队列 里 插入 回调 函数 


> Var http = require('http'); 
> var s = http.createServer (function(req, res) { 
. res.writeHead(200, {}); 
. res.end('foo'); 
. Console.log('http response'); 
... process.nextTick (function() {console.log('tick')}); 
ar 
> s.listen(8000); 
> http response 
tiek 
http response 
tick 




















这 个 例子 创建 了 一 个 HTTP 服务 器 。 服 务 端 监听 请 求 事件 的 函数 调用 process. 


山中 
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nextTick() 创建 了 一 个 回调 函数 。 无 论 我 们 向 HTTP 服务 器 发 起 多 少 次 请 求 ，tick 
每 次 都 会 出 现在 事件 循环 的 下 一 个 轮回 中 。nextTick() 回调 函数 不 像 其 他 回调 函 
数 那样 是 一 个 单独 的 事件 ， 因 此 也 不 像 一 般 回 调 函 et 如 例 5-25 和 例 
5-26 所 示 。 











例 5-25 在 其 他 代码 异常 之 后 ，nextTick() 继续 工作 


process.on('uncaughtException', function(e) { 
console.log(e); 


}) ; 


process.nextTick (function() { 
console.log('tick'); 

} 

process.nextTick (function() { 
iAmAMistake(); 
console.log('tock'); 

})s 

process.nextTick (function() { 
console.log('tick tock'); 

De 


console.log('End of 1st loop'); 





例 5-26 例 5-25 运行 结果 


Enki:~ $ node process-next-tick.js 

End of lst loop 

EC 

{ stack: [Getter/Setter], 
arguments: [ 'iAmAMistake' ]， 
type; not defined"; 
message: [Getter/Setter] } 

tick tock 

Enki:~ $ 


尽管 故意 制造 了 错误 ， 但 与 其 他 在 单个 事件 内 的 回调 函数 不 同 ，tick 中 的 每 一 个 国 
数 都 被 隔离 开 了 。 让 我 们 来 看 一 下 代码 。 首 先 ， 我 们 设置 了 异常 监听 器 来 捕获 所 有 
的 异常 。 其 次 ， 调 用 process .nextTick() 设置 了 儿 个 回调 函数 。 每 一 个 回调 函 
数 都 会 输出 到 终端 。 但 是 ， 第 二 个 函数 有 一 个 故意 的 错误 。 最 后 ， 我 们 在 终端 记录 
一 条 消息 。 当 Node 运行 这 个 程序 的 时 候 ， 它 先 处 理 了 所 有 的 代码 ， ee 
输出 'End of lst loop'。 然 后 它 按 顺序 调用 了 nextTice () 中 的 回调 函数 。 
Re 输出 后 ， 我 们 抛 出 了 异常， 因为 遇 到 了 下 一 Ps i 
错误 导致 进程 触发 了 一 个 uncaughtException 事件 ， 并 使 得 我 们 的 函数 把 
ee 江上 。 因 为 抛 出 了 异常 ，'tock' 并 没有 在 终端 打印 出 来 , 但 'tick 
tock' 依然 打印 了 ， 这 是 因为 每 次 调用 nextTick() 的 时 候 ， ee 
中 创建 的 。 你 可 能 会 想到 将 要 被 触发 的 事件 是 在 事件 循环 当前 遍历 的 内 部 执行 
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而 与 其 他 事件 相 比 ，nextTick() 则 是 在 事件 循环 的 遍历 开始 前 被 调用 的 。 最 后 ， 
其 他 事件 在 事件 循环 内 按 顺序 执行 。 























5.3.2” 子 进程 

你 可 以 使 用 chil9_process 模块 来 为 Node 主 进 程 创建 子 进 程 。 因 为 Node 的 单 进 
程 只 有 一 个 事件 循环 ， 所 以 有 时 候 创 建 子 进程 是 很 有 用 的 。 比 如 ， 你 可 能 需要 用 此 
方法 来 更 好 地 利用 CPU 的 多 核 ， 而 单个 Node 进程 只 能 使 用 其 中 一 个 核 。 或 者 说 ， 
你 可 以 用 child_process 来 启动 其 他 程序 ， 然 后 与 其 交互 。 特 别 是 当 你 在 编写 命 
令 行 脚本 的 时 候 ， 这 会 非常 有 用 。 


child_process 有 两 个 主要 的 方法 。spawm () 会 创建 一 个 子 进程 ， 并 且 有 独立 的 
stdin、stdout 和 stderr 文件 描述 符 。exec () 会 创建 子 进程 ， 并 会 在 进程 结束 的 时 候 
以 回调 函数 的 方式 返回 结果 。 创 建 子 进程 的 方法 有 很 多 种 ， 其 中 一 种 依然 是 非 阻 塞 
的 方式 ， 而 且 不 需要 你 写 额外 的 代码 来 推动 运行 。 


所 有 的 子 进程 都 有 一 些 公共 的 属性 。 它 们 每 个 都 包含 了 stdin、stdout 和 stderr 的 特 
性 ,正如 我 们 在 上 一 小 节 所 讨论 的 那样 。 此 外 它们 还 有 一 个 pia 属性 ， 它 包含 了 该 
子 进程 的 OS 进程 ID。 子 进程 在 退出 的 时 候 会 触发 exit 事件 。 其 他 data 事件 可 
以 通过 child process.stdin、 child process.stdout 和 child process. 
stderr 的 流 方 法 获得 。 














1. child Process .exec () 


让 我 们 用 最 直观 的 使 用 情景 来 介绍 exec () 吧 。 使 用 exec() ， 你 可 以 创建 一 个 子 进 
程 来 运行 其 他 程序 (也 可 以 是 另外 一 个 Node 程序 )， 然 后 在 回调 函数 中 返回 执行 的 
结果 ( 例 5-27)。 





例 5-27 用 exec() 调用 1s 


Var Cp = Yequireé'('child process'); 


cp.exec('ls -1', function(e, stdout, stderr) { 
if(!e) { 
console.log(stdout); 
console.log(stderr); 
} 
> 


当 调 用 exec () 时 ， 可 以 输入 一 个 命令 行 指令 让 新 创建 的 进程 去 执行 。 注 意 整个 命 
令 是 一 个 字符 串 。 如 果 你 需要 给 命令 传人 参数 ， 也 需要 将 其 包含 在 字符 串 里 。 在 这 
个 例子 中 ， 我 们 传 给 1s 命令 -1 参数 ， 用 来 指定 输出 格式 为 详细 格式 。 你 还 可 以 使 
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用 复杂 的 命令 行 功能 ， 比 如 “| 来 实现 管道 命令 。Node 会 返回 管道 中 最 后 一 个 命 


回调 函数 接收 3 个 参数 : 一 个 error 对 象 、stdout 的 结果 和 stderr 的 结果 。 注 意 调 
用 的 1s 命令 会 运行 在 Node 程序 当前 所 在 的 工作 目录 中 ， 你 可 以 调用 process. 
cwd () 获得 这 个 目录 。 


重要 的 是 要 了 解 第 一 个 和 第 三 个 参数 的 区 别 。 如 果子 进程 返回 了 错误 的 状态 码 或 者 
是 有 其 他 异常 发 生 ，error 对 象 就 不 会 是 null1。 当 子 进程 退出 时 ， 它 会 把 状态 传 回 
给 父 进程 。 比 如 ， 在 Unix 中 ，0 是 表示 成 功 ， 大 于 0 的 8 位 数字 则 用 来 表示 错误 。 
error 对 象 也 可 以 用 来 表示 被 调用 的 命令 不 满足 Node 对 它 的 限制 。 当 错误 代码 从 子 
进程 返回 时 ，error 对 象 会 包含 错误 代码 和 stderr。 但 是 ， 若 一 个 子 进程 运行 是 成 功 
的 ，stderr 中 依然 可 以 有 数据 。 


exec () 的 第 二 个 参数 可 以 是 一 个 可 选 的 配置 对 象 。 默 认 情 况 下 ， 这 个 对 象 包 含 了 
如 例 5-28 所 示 的 属性 。 














例 5-28 chilqg process.exec() 的 默认 配置 对 象 


Var options = { encoding: 'utf8', 
timeout: 0， 
maxBuffer: 200 * 1024, 
killSignal: 'SIGTERM', 
setsid: false, 
cwd: null, 
env: null }; 


这 些 属性 如 下 。 


。 encoding 


IO 流 输 入 字符 的 编码 格式 。 


timeout 

进程 运行 的 时 间 ， 以 毫秒 为 单位 。 

。 killSignal 

当时 间或 Buffer 大 小 超过 限制 时 ， 用 来 终止 进程 的 信号 。 


。 maxBuffer 


stdout 或 stderr 允许 最 大 的 大 小 ， 以 千 字 节 为 单位 。 


。 setsid 


是 否 创建 Node 子 进程 的 新 会 话 。 
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。 cwd 


为 子 进程 初始 化 工作 目录 (nul1 表示 使 用 当前 的 进程 工作 目录 )。 
°° env 

进程 的 环境 变量 。 所 有 的 环境 变量 都 可 以 从 父 进 程 继 承 。 
让 我 们 设置 一 些 选 项 来 给 子 进程 一 些 限制 吧 。 首 先 ， 我 们 限制 响应 数据 的 Buffer 
大 小 ， 如 例 5-29 所 示 。 





例 5-29 限制 chilq process.exec() 调用 的 Buffer 大 小 


> var child = cp.exec('ls', {maxBuffer:1}, function(e, stdout, stderr) { 
. Console.log(e); 
ed 
2 
> { stack: [Getter/Setter], 
arguments: undefined, 
type: undefined, 
message: 'maxBuffer exceeded.' } 


在 本 例 中 ， 你 可 以 看 见 我 们 设置 了 一 个 很 小 的 maxBuffer (只 有 1kb)， 所 以 运行 
ls 命令 很 快 就 耗 尽 所 有 的 可 用 空间 并 且 抛 出 错误 。 因 此 检查 错误 很 重要 ， 这 让 你 能 
够 用 合理 的 方法 来 处 理 它们 。 因 为 你 已 经 限制 在 chnilg process 里 ， 所 以 你 不 会 
希望 由 于 访问 了 不 存在 的 资源 而 导致 真正 的 异常 发 生 。 如 果 child_process 返回 
了 一 个 错误 ， 它 的 stain 和 stdout 属性 就 不 可 用 了 ， 因 此 如 果 再 去 访问 它们 将 会 
抛 出 异常 。 

我 们 也 可 以 在 子 进 程 运 行 超过 一 定时 间 后 ， 把 它 终 止 掉 ， 如 例 5-30 所 示 。 

例 5-30 process.exec() 调用 时 设置 超时 


> var child = cp.exec('for i in {1..100000};do echo $i;done', 
. {timeout:500, killSsignal:'SIGKILL'}, 
. function(e, stdout, stderr) { 

console.log(e); 


这 个 例子 定义 了 一 个 故意 长 时 间 运 行 的 进程 (在 shell 脚本 中 从 1 数 到 100 000), 但 
我 们 又 设置 了 一 个 很 短 的 超时 。 注 意 ， 我 们 还 指定 了 killsignal。 默 认 的 终止 信 
号 是 SIGTERM， 但 我 们 使 用 SIGKILL 来 展示 这 个 功能 。 得 到 错误 的 返回 时 ， 注 
意 一 下 其 中 的 killed 属性 ， 它 会 告诉 我 们 Node 主动 终止 了 该 进程 ， 并 且 它 没有 自 
行 退 出 。 这 对 于 前 一 个 例子 也 同样 成 立 。 因 为 它 不 是 自己 主动 退出 的 ， 所 以 也 没有 
code 属性 及 其 他 关于 系统 错误 的 属性 。 




















注 3: SIGKILL 可 以 在 命令 行 用 kill -9 产生 。 











2. child process.spawn() 





spawn () 和 exec () 很 像 ， 但 它 是 一 个 更 加 通用 的 方法 。 它 要 求 你 自己 处 理 流 和 它 
们 的 回调 函数 。 这 让 它 的 功能 更 加 强大 和 灵活 ， 但 这 也 意味 着 需要 编写 更 多 的 代码 
才能 达到 exec () 那些 一 下 子 就 能 完成 的 功能 。 所 以 spawn () 最 常见 的 用 途 是 用 来 
在 服务 器 开发 中 创建 服务 器 程序 的 子 模块 ， 它 也 是 人 们 使 Node 运行 在 一 台 机 器 的 
多 个 CPU 核 上 的 最 常见 方式 。 

















虽然 其 功能 和 exec() 一 样 ， 但 spawn () 的 API 还 是 有 些 差 异 的 ( 例 5-31 和 例 
5-32)。 ee ， 但 与 exec () 不 同 ， 它 不 再 是 

个 命令 字符 串 ， We 程序。 进程 的 参数 以 数组 的 形式 作为 第 一 个 (可 选 
的 ) 参数 传 给 spawn () 。 这 和 process .argv 的 反 向 操作 类 似 : 不 是 把 命令 按 空 格 
分 隔 开 ， 而 是 提供 一 ee (人 (7 


最 后 ，spawn() 还 可 以 接受 一 ee 配置 的 部 分 属性 与 
exec ( we 我 们 马上 会 进一步 介 


例 5-31 用 spawn () 启动 子 进程 


var cp = require('child process'); 
var cat = cp.spawn('cat'); 


cat stdout .onm(" data, funcetion(d) { 
console.log(d.toSstring()); 

人 六 

cat.on('exit', function() { 
console.log('kthxbai').,; 


的 人 


cat.stdin.write('meow'); 
cat.stdin.end(); 


例 5-32 例 5-31 的 运行 结果 


Enki:~ $ node cat.js 
meow 

kthxbai 

Enki:~ $ 





在 上 面 的 例子 中 ， 我 们 使 用 了 Unix 程序 的 cat 命令 ， 它 会 把 所 有 输入 的 内 容 都 复 

一 遍 并 打印 出 来 。 你 会 看 到 ， 与 exec () 不 同 ， 我 们 没有 直接 给 spawn () 指定 回 
调 函 数 ， 因 为 期 待 使 用 子 进程 类 提供 的 流 事 件 来 读 取 并 发 送 数 据 。 我 们 把 子 进程 的 
实例 命名 为 “cat” 变 量 ， 然 后 就 可 以 通过 cat .stdout 来 设置 子 进 程 stdout 流 的 事 
件 监 听 器 了 。 我 们 为 cat .stqout 设置 了 监听 器 来 监控 所 有 的 aata 事件 ， 并 且 对 
子 进 程 本 身 设 置 了 exit 事件 的 监听 器 。 通 过 其 child.stain 流 ， 就 可 以 接着 往 子 
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进程 的 stdin 中 发 送 数 据 。 这 只 是 一 个 普通 的 可 写 数据 流 ， 但是， 由 于 cat 程序 的 
行为 特点 ， 当 我 们 关闭 stdin 的 时 候 ， 子 进程 就 会 退出 。 这 并 非 对 所 有 程序 都 有 效 ， 
但 对 于 cat 程序 来 说 是 有 效 的 ， 因 为 它 的 存在 只 是 为 了 把 数据 回 显 。 


传 给 spawn () 的 配置 内 容 并 非 和 exec() 完全 一 样 ， 这 是 因为 你 需要 对 spawn () 
进行 更 多 的 手工 操作 。env、setsid 和 cwd 属性 都 是 spawn() 的 可 选项 。 还 有 
uid 和 giq， 分 别 用 来 设置 用 户 ID 和 组 ID。 与 process 类 似 ， 设 置 uid 或 gia 
来 修改 用 户 名 或 用 户 组 的 名 称 会 因为 查找 用 户 或 用 户 组 而 短暂 堵塞 。spawn () 还 
比 exec () 多 一 个 配置 项 ， 你 可 以 设置 自 定义 的 文件 描述 符 来 传 给 新 建立 的 子 进程 。 
让 我 们 多 花 点 时 间 在 这 个 话题 上 吧 ， 毕 竞 它 有 点 复杂 。 


Unix 系统 中 的 文件 描述 符 是 用 来 记录 跟踪 该 程序 正在 对 哪些 文件 进行 操作 的 方法 。 
因为 Unix 允许 多 个 程序 同时 运行 ， 所 以 需要 有 方法 来 确保 这 些 程序 在 修改 文件 系统 
时 不 会 不 小 心 把 别人 的 修改 覆盖 。 文 件 描 述 符 表 是 用 来 记录 一 个 进程 想 要 访问 的 所 
有 文件 信息 的 ， 内 核 可 能 会 为 了 防止 两 个 程序 同时 修改 一 个 文件 而 把 某 个 特定 的 文 
件 锁 住 ， 当 然 还 有 其 他 管理 功能 。 进 程 会 从 文件 描述 符 表 中 查找 某 个 文件 对 应 的 文 
件 描述 符 ， 然 后 传 给 内 核 去 访问 该 文件 。 文 件 描述 符 其 实 只 是 用 一 个 整数 来 表示 。 


重要 的 一 点 是 ， 文 件 描述 符 这 个 名 字 有 点 虚幻 ， 因 为 它 并 不 是 单纯 地 表示 文件 。 网 
络 或 其 他 socket 一 类 的 东西 也 是 分 配 成 文件 描述 符 。Unix 的 跨 进程 通信 (IPC) 
socket 可 以 用 来 让 进程 间 互 相 发 消息 ， 我 们 称 它们 为 stdin、stdout 和 stderr。 当 
spawn () 允许 我 们 在 创建 新 的 子 进程 时 指定 文件 描述 符 时 ， 情 况 变 得 有 趣 起 来 。 这 
意味 着 ， 不 必 由 操 作 系 统 指派 一 个 新 的 文件 描述 符 ， 我 们 可 以 要 求 子 进 程 与 父 进程 
一 起 共享 一 个 已 经 存在 的 文件 描述 符 。 该 文件 描述 符 可 以 是 一 个 连接 在 互联 网 的 网 
络 socket， 或 者 只 是 父 进程 的 stdin。 但 重点 是 ， 我 们 有 了 一 个 功能 强大 的 方法 来 把 
工作 分 配给 子 进程 了 。 














这 是 如 何 做 到 的 呢 ?” 当 传递 options 对 象 给 spawn() 时 ， 我 们 可 以 指定 cus- 
tomFds 来 把 自己 拥有 的 3 个 文件 描述 符 传递 给 子 进程 ， 这 样 进程 就 不 需要 创立 新 
的 stdin、stdout 和 stderr 文件 描述 符 了 ( 例 5-33 和 例 5-34)。 
例 5-33 把 stdin、stdout 和 stderr 传 给 子 进程 

Var cp = require('child process'); 

var child = cp.spawn('cat', [], {customFds:[0, 1, 2]}); 


例 5-34 运行 例 5-33， 并 通过 stdin 用 管道 传人 数据 


Enki:~ $ echo "foo" 
foo 








Enki:~ $ echo "foo" | node 


readline.js:80 
tty.setRawMode (true); 


Error: ENOTTY, Inappropriate ioctl for device 
at new Interface (readline.js:80:9) 
at Object.createInterface (readline.js:38:10) 
at new REPLServer (repl.js:102:16) 
at Object.start (repl.js:218:10) 
at Function.runRepl (node.js:365:26) 
at startup (node.js:61:13) 
at node.js:443:3 


Enki:~ $ echo "foo" | cat 

foo 

Enki:~ $ echo "foo" | node fds.js 
foo 

Enki:~ $ 


文件 描述 符 0、1、2 分 别 代 表 了 stdin、stdout 和 stderr。 在 例子 中 ,我 们 创建 了 
一 个 子 进 程 ， 并 从 父 进程 给 它 传 递 stdin、stdout 和 stderr。 可 以 在 命令 行 里 进行 
连接 测试 。ecnho 命令 可 以 打印 出 字符 串 fgo。 如 果 直 接 把 它 用 管道 传 给 node 程序 
(stdout 到 stdin) ， 结 果 是 出 错 。 但 是 ， 我 们 可 以 把 它 传递 给 cat 命令 ， 它 会 把 内 
容 回 显 出 来 。 同 样 ， 如 果 把 内 容 通 过 管道 传 给 运行 脚本 的 Node 程序 ， 它 也 会 把 内 
容重 复出 来 。 这 是 因为 我 们 将 Node 进程 的 stdin、stdout 和 stderr 都 与 子 进程 中 的 
cat 程序 绑 定 在 一 起 了 。 当 Node 主 进程 从 stdin 得 到 数据 的 时 候 ， 它 会 传 给 cat 子 
进程 ， 并 由 cat 程序 把 内 容 回 传 给 共享 的 stdout。 要 注意 的 一 点 是 ,一 旦 你 把 Node 
程序 以 这 种 方式 连接 起 来 ， 子 进程 就 丢失 了 它 的 child.stdin、child.stdout 和 
child.stqerr 的 文件 描述 符 引 用 。 这 是 因为 一 旦 把 文件 描述 符 传 递 给 子 进程 ， 
们 就 会 被 复制 ， 并 且 由 内 核 来 处 理 数据 传递 。 因 此 ，Node 并 不 是 在 进程 ss 
符 之 间 (FD) ， 所 以 你 无 法 对 这 些 数据 流 添 加 事件 监听 器 〈 见 例 5-35、 例 5-36) 。 


例 5-35 当 传递 自 定义 文件 描述 符 后 ， 尝 试 访问 这 些 文件 描述 符 流 失败 


Var cp = require('child process'); 
var child = cp.spawn('cat', [], {customFds:[0, 1, 2]}); 
child.stdout.on("'data'; function'(d) { 

console.log('data out'); 


}) ; 
例 5-36 测试 结果 


Enki:~ $ echo "foo" | node fds.js 








node.js:134 
throw e; // process.nextTick error, or 'error' event on first tick 
foo 


» 





TypeError: Cannot call method 'on' of null 
at Object.<anonymous> (/Users/croucher/fds.js:3:14) 
at Module. compile (module.js:404:26) 
at Object..js (module.js:410:10) 
at Module.load (module.js:336:31) 
at Function. load (module.js:297:12) 
at Array.<anonymous> (module.js:423:10) 
at EventEmitter. tickCallback (node.js:126:26) 
Enki:~ $ 
当 指 定 了 自 定义 的 文件 描述 符 ， 这 些 流 就 被 显 式 地 设置 为 null1， 并 且 完 全 不 能 从 父 
进程 访问 了 。 但 在 许多 情况 下 这 是 有 价值 的 ， 因 为 比 起 用 Node 的 stream.pipe () 
把 数据 流连 接 起 来 ,通过 内 核 来 分 发 要 快 很 多 。 而 且 ，stdin、stdout 和 stderr 并 
非 仅 有 的 儿 个 值得 用 来 连接 子 进程 的 文件 描述 符 。 一 个 常见 的 使 用 情境 是 把 网 络 
socket 和 一 组 子 进程 相连 接 ， 来 利用 多 核 的 性 能 。 


假设 我 们 在 创建 一 个 网 站 或 游戏 服务 器 ， 或 者 任何 需要 处 理 大 量 流 量 的 应 用 。 我 们 
有 着 强大 的 服务 器 ， 上 面 有 一 堆 处 理 器 ， 每 个 又 有 2 个 或 4 个 核 。 假 如 只 是 简单 地 
启动 Node 进程 来 运行 代码 ， 就 只 能 用 上 一 个 核 。 虽然 CPU 通常 不 是 Node 程序 的 
核心 因素 ， 但 我 们 还 是 想 尽 量 接近 CPU 的 极限 。 此 时 我 们 可 以 把 Node 程序 启动 
到 不 同 的 端口 上 ， 然 后 利用 Nginx 或 Apache 来 进行 负载 均衡 。 但 是 ， 这 样 做 并 不 
优雅 ， 而 且 要 使 用 更 多 的 软件 。 我 们 也 可 以 让 Node 进程 启动 许多 子 进程 ， 然 后 把 
请 求 分 发 给 它们 。 这 离 理 想 解 决 方案 已 经 很 接近 了 ， 但 是 这 个 方法 会 出 现 一 个 单 点 
故障 ， 因 为 只 有 一 个 Node 进程 来 分 发 所 有 的 数据 ， 这 还 不 够 理想 。 现 在 就 是 传递 
custom FD 大 显 身 手 之 时 了 。 用 传递 主 进程 stdin、stdout 和 stderr 同样 的 方法 ， 我 
们 可 以 创建 其 他 socket 并 且 把 它们 传 给 子 进程 。 但 因为 我 们 传递 的 是 文件 描述 符 而 
不 是 消息 ， 所 以 内 核 会 负责 处 理 分 发 。 这 意味 着 ， 即 使 依然 需要 有 一 个 主 Node 进 
程 ， 但 是 它 不 再 需要 承载 所 有 的 流量 负荷 了 。 


5.4 用 assert 来 测试 


assert 是 为 测试 代码 提供 基础 功能 的 核心 库 。Node 的 断言 功能 与 其 他 开发 语言 
环境 所 提供 的 功能 很 类 似 : 允许 你 为 对 象 或 函数 调用 提出 要 求 ， 并 且 在 破坏 断言 的 
时 候 发 出 信息 。 这 些 方法 都 很 容易 使 用 ， 并 能 为 代码 单元 测试 提供 许多 便利 。Node 
自己 的 测试 也 是 用 assert 编写 的 。 

assert 的 许多 方法 都 是 成 对 出 现 的 ， 一 个 方法 提供 了 正面 的 测试 ， 另 一 个 就 提供 
反面 的 功能 。 比 如 例 5-37 演示 的 equal () 和 notEadual () 。 这 些 方法 接受 两 个 参 
数 ， 第 一 个 是 期 待 的 值 ， 第 二 个 是 实际 的 值 。 









































例 5-37 assert 的 基本 功能 


> Var assert = require('assert'),; 
> assert.equal(1, true, 'Truthy'); 
> assert.notEqual (1, true, 'Truthy'); 
AssertionError: Truthy 
at [object Context]:1:8 
at Interface.<anonymous> (repl.js:171:22) 
at Interface.emit (events.js:64:17) 
at TInterface, onLine (readline,.js:153;10) 
at Interface. line (readline.js:408:8) 
at Interface. ttyWrite (readline.js:585:14) 
at ReadStream.<anonymous> (readline.js:73:12) 
at ReadStream.emit (events.js:81:20) 
at ReadStream. emitKey (tty posix.js:307:10) 
at ReadStream.onData (tty posix.js:70:12) 
2 


这 里 最 明显 的 就 是 assert 方法 不 通过 时 ,会 抛 出 异常 。 这 是 测试 套件 的 基本 原则 。 
当 一 个 测试 套件 运行 时 ， 它 应 该 只 是 运行 ， 不 会 抛 出 异常 。 在 这 种 情况 下 ,测试 会 
被 认为 是 成 功 的 。 


只 有 几 个 断言 函数 ， 如 equal() 和 notEqual()， 会 检查 相等 (==) 和 不 相等 
(!=) 操作 。 这 意味 着 其 他 的 测试 只 会 弱化 地 检查 真 值 和 假 值 (truthy 和 falsy， 这 
是 Crockford 给 它们 起 的 名 称 )。 简 单 而 言 ， 当 测试 作为 一 个 布尔 值 时 ， 假 值 包 
含 了 false、0、 空 字符 串 (如 "")、null、undefined 和 NaN， 所 有 其 他 值 都 为 真 
值 。 一 个 像 "false" 这 样 的 字符 串 是 真 值 ， 一 个 包含 "0" 的 字符 串 也 是 真 值 。 而 
edaual () 和 notEqual() 可 以 用 来 比较 两 个 简单 对 象 的 值 (如 字符 串 、 数 字 )。 但 
你 需要 仔细 检查 布尔 值 ， 以 确保 得 到 想 要 的 结果 。 


Be en ) 和 notstrictEqual() 方法 检测 两 个 数值 是 否 相 等 时 会 采用 === 
和 !==， 这 样 可 以 确保 测试 时 的 true 和 false 可 分 别 被 作为 真 和 假 来 对 待 。 例 
5-38 中 的 ok () 方法 是 用 来 测试 一 个 对 象 是 否 为 真 值 的 简便 方法 ， 它 会 使 用 == 来 对 
比 测试 对 象 和 true 是 否 一 样 。 


例 5-38 用 assert.ok() 测试 某 个 对 象 是 否 为 真 值 


> assert.ok('This is a string', 'Strings that are not empty are truthy'); 
> assert.ok(0, 'Zero is not truthy'); 
AssertionError: Zero is not truthy 

at [object Context] :1:8 

at Interface.<anonymous> (repl.js:171:22) 

at Interface.emit (events.js:64:17) 

at Interface, onLine (readline.,js:153;10) 

at Interface. line (readline.js:408:8) 

at Interface. ttyWrite (readline.js:585:14) 

at ReadStream.<anonymous> (readline.js:73:12) 

at ReadStream.emit (events.js:81:20) 











at ReadStream. emitKey (tty posix.js:307:10) 
at ReadStream.onData (tty posix.js:70:12) 


但 通常 你 想 要 比较 的 内 容 并 不 是 简单 值 ， 而 是 对 象 。JavaScript 并 没有 提供 某 种 方 
法 来 让 对 和 象 为 自己 定义 相等 运算 符 。 即 使 它 允 许 这 样 做 ， 人 们 通常 也 不 会 定义 运算 
符 。 所 以 deepEqual () 和 notDeepEqual () 方法 提供 了 深入 比较 两 个 对 象 值 的 方 
法 。 这 些 方法 会 进行 若干 测试 ， 而 无 需 太 多 的 细节 。 如 果 任 何 一 个 检查 失败 了 ， 测 
试 就 会 抛 出 异常 。 首 先 检查 的 是 若 用 简单 的 === 操作 来 比较 ， 两 个 值 的 结果 是 否 相 
和 等。 接着， 检查 一 下 它们 的 类 型 是 否 为 Buffer， 如 果 是 ， 则 检查 它们 的 长 度 ， 然 
后 按 字 节 对 比 。 如 果 对 象 的 类 型 按 == 运算 符 不 匹配 ， 它 们 就 不 可 能 相等 。 最 后 ， 
如 果 比 较 的 参数 是 对 象 类 型 ， 会 进行 更 加 严格 的 测试 ， 如 比较 两 个 对 象 的 原型 、 属 
性 数量 ， 然 后 对 每 个 属性 执行 deepEqual () 以 进行 递归 比较 。 


这 里 需要 重点 指出 ，deepEqual() 和 notDeepEqual () 是 非常 有 用 的 ， 但 是 代价 
可 能 很 大 。 你 应 该 只 在 需要 的 时 候 才 使 用 它们 。 虽 然 这 些 方法 都 尝试 先 做 最 快速 的 
测试 ， 但 可 能 需要 花费 较 长 的 时 间 才 能 找到 不 一 致 的 地 方 。 如 果 你 提供 的 对 象 更 加 
精确 ， 如 用 对 象 的 某 个 属性 来 代替 整 个 对 象 ， 就 可 以 显著 提高 测试 的 性 能 。 


























接 下 来 要 介绍 的 assert 方法 是 throws () 和 doesNotThrow()。 这 些 方法 会 检查 
指定 的 代码 块 是 否 会 抛 出 异常 。 你 可 以 检测 指定 的 异常 ， 或 者 是 任意 的 异常 是 否 抛 


出 。 这 些 方法 都 很 直观 ， 但 有 几 个 选项 需要 研究 一 下 。 


大 家 很 容易 忽略 这 些 测试 ， 但 处 理 异常 是 编写 健壮 JavaScript 代码 的 重要 组 成 部 分 ， 
所 以 你 该 使 用 这 些 测 试 来 确保 写 出 的 代码 在 正确 的 地 方 抛 出 异常 。 第 3 章 提 供 了 更 
多 关于 处 理 异 常 的 信息 。 


要 把 代码 块 传 给 throws () 和 doesNotThrow()， 需 要 把 它们 包含 在 一 个 没有 参数 
的 函数 里 ( 例 5-39)。 待 测试 的 异常 是 可 选 的 ， 如 果 没 有 传 信 ，throws () 会 检查 
是 否 有 异常 发 生 ， 而 doesNotThrow() 会 确保 不 抛 出 异常 。 如 果 指 定 了 错误 类 型 ， 
throws () 会 检查 该 指定 的 异常 ， 并 且 只 会 抛 出 该 类 型 的 异常 。 如 果 任 意 其 他 的 异 
党 抛 出 来 ， 或 者 指定 的 异常 没有 抛 出 ， 测 试 都 不 会 通过 。 对 于 aoesNotThrow ()， 
当 指 定 了 一 个 错误 ， 如 果 有 指定 异常 之 外 的 任何 异常 抛 出 时 ， 它 都 会 继续 运行 。 而 
如 果 指 定 的 异常 出 现 了 ， 测 试 就 会 中 断 。 


例 5-39 用 assert.throws() 和 assert.doesNotThrow() 检查 异常 处 理 


> asSsert .hzrows ( 
. function() { 
throw new Error("Seven Fingers. Ten is too mainstream."); 


me 





> assert .qdqoesNotThrow ( 
: FuncEiorm() 六 
throw new Error("I lived in the ocean way before Nemo"); 
Rs 
AssertionError: "Got unwanted exception (Error).." 
at Object. throws (assert.js:281:5) 
at Object.doesNotThrow (assert.js:299:11) 
at [object Context]:1:8 
at Interface.<anonymous> (repl.js:171:22) 
at Interface.emit (events.js:64:17) 
at TInterface, onLine (readline,Jjs:153;10) 
at Interface. line (readline.js:408:8) 
at Interface. ttyWrite (readline.js:585:14) 
at ReadStream.<anonymous> (readline.js:73:12) 
at ReadStream.emit (events.js:81:20) 
> 


有 4 种 方法 可 用 来 指定 要 查看 或 避免 的 错误 类 型 ， 我 们 可 以 传人 以 下 类 型 。 

。 比较 函数 
该 函数 只 接收 一 个 参数 ， 即 异常 错误 对 象 。 在 函数 里 比较 传人 的 异常 是 否 与 你 想 
查找 的 类 型 匹配 ， 如 果 匹 配 则 返回 真 ， 否 则 返回 假 。 

。 正则 表达 式 
国 数 库 会 根据 正则 表达 式 来 比较 错误 消息 是 否 匹 配 你 的 要 求 ， 采 用 的 是 
JavaScript 的 regex.test () 方法 。 











。 字符 串 
函数 库 会 直接 比较 错误 消息 与 指定 的 字符 串 。 

。 对 象 构造 类 型 
函数 库 会 用 typeof 来 对 异常 进行 操作 并 测试 。 如 果 该 测试 在 调用 typeof 时 抛 
出 错误 ， 则 认为 异常 类 型 匹配 ， 这 可 以 用 来 使 throws () 和 doesNotThrow() 变 
得 更 为 灵活 。 


5.5 虚拟 机 


虚拟 机 (vm) 模块 让 你 可 以 运行 任意 一 块 代码 ， 并 得 到 运行 结果 。 它 提供 了 一 些 功 
能 ， 可 以 修改 指定 代码 运行 的 上 下 文 。 这 很 有 用 ， 比 如 可 以 用 来 作为 人 造 沙 箱 。 但 
是 代码 还 是 运行 在 同一 个 Node 进程 里 ， 所 以 你 依然 需要 小 心 行事 。vm 和 eval () 
类 似 ， 但 提供 了 更 多 功能 和 更 好 的 API 来 管理 代码 。 然 而 ， 它 不 像 esval () 那样 能 
提供 与 本 地 作用 域 互 动 的 能 


用 vm 运行 代码 有 两 种 方法 。 第 一 种 与 使 用 eval () 的 方法 类 似 ， 把 代码 内 髓 运行 ; 
第 二 种 是 先 把 代码 预 编 译 成 vm.script 对 象 。 我 们 看 一 下 例 5-40， 它 演示 了 如 何 
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用 vm 内山 运 行 代码 。 
例 5-40 用 vm 来 运行 代码 


> Var vm = require('vm'); 
> vm.runInThisContext ("1+1"); 
亚 


到 目前 为 止 ，vm 看 起 来 都 很 像 eval () 。 我 们 给 它 传 和 一段 代码 ， 它 就 返回 了 结果 。 
但 是 ，vm 并 不 会 像 eval () 那样 改变 本 地 作用 域 的 内 容 。 用 eval () 执行 的 代码 会 
像 真 的 戏 入 在 当前 位 置 运 行 一 样 ， 并 且 替 换 掉 eval () 国 数 调 用 ， 而 调用 vm 方法 就 
不 能 这 样 作 用 于 本 地 作用 域 了 。 所 以 说 ，eval () 会 修改 周围 的 上 下 文 ， 但 vm 不 会 
( 例 5-41)。 


例 5-41 使 用 vm 和 eval() 在 访问 本 地 作用 域 时 的 区 别 


> Var vm = require('vm'), 





vm.runIinThisContext ('v=v+1'); 

ReferenceError: V is not defined 

at evalmachine.<anonymous>:1:1 

at [object Context]:1:4 

at Interface.<anonymous> (repl.js:171:22) 

at Interface.emit (events.js:64:17) 

at Interface. onLine (readline.js:153:10) 

at Interface. line (readline.js:408:8) 

at Interface. ttyWrite (readline.js:585:14) 
at ReadStream.<anonymous> (readline.js:73:12) 
at ReadStream.emit (events.js:81:20) 

at ReadStream. emitKey (tty posix.js:307:10) 


vm.runInThisContext ('v=0')，; 





vm.runIinThisContext ('v=v+1'); 


OV PV OV Vv 


我 们 创建 了 e 和 两 个 变量 。 在 eval () 中 使 用 变量 ee 时， 代码 执行 结束 后 ， 该 结 
果 会 影响 正文 内 容 。 但 是 当 对 变量 Vv 用 vm.runInThisContext ( ) 党 试 做 同样 的 操 
作 时 ， 得 到 的 结果 是 出 现 异常 ， 因 为 对 变 i 而 该 变量 还 没 
有 定义 。eval () 是 运行 在 当前 作用 域 的 ， 而 vm 不是。 


vm 实际 上 会 在 每 一 个 实例 的 内 部 ， 维 护 一 套 独 立 的 本 地 上 下 文 ， 并 且 能 够 保持 状 
态 。 因 此 ， 当 我 们 在 vm 的 作用 域内 创建 了 变量 v， 该 变量 就 能 够 在 同一 个 vm 的 后 
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续 操 作 中 有 效 ， 并 且 保 持 上 一 次 调用 时 的 状态 。 但 是 vm 内 的 变量 v 并 不 会 影响 运 
行 在 主事 件 循环 中 的 本 地 作用 域 。 


此 外 ， 也 可 以 传 给 vm 一 个 已 经 存在 的 上 下 文 内 容 。 该 上 下 文 会 作为 默认 的 上 下 文 
使 用 。 


例 5-42 使 用 了 vm.runInNewContext ()， 并 以 第 二 个 参数 作为 上 下 文 对 象 。 该 对 
象 的 作用 域 就 成 了 我 们 用 vm 运行 代码 的 上 下 文 如 果 我 们 继续 把 它 传 给 不 同 的 调 
用 ， 此 上 下 文 就 会 被 修改 。 而 且 ， 这 个 上 下 文 能 够 被 全 局 作用 域 使 用 。 


例 5-42 传 给 vm 上 下 文 





> Var vm = require('vm'); 

> var context = { alphabet:"" }; 

> vm.runInNewContext ("alphabet+='a'", context); 
| 

> vm.runInNewContext ("alphabet+='b'", context); 
Vat 


» CONMtext 
{ alphabet: 'ab' } 
> 





你 也 可 以 把 代码 编译 成 vm.script 对 象 ( 例 5-43)。 这 样 就 可 以 重复 运行 同一 段 代 
码 ， 从 而 节省 一 些 代码 量 。 在 运行 的 时 候 ， 你 可 以 选择 用 哪个 上 下 文 来 执行 ， 这 样 
就 可 以 很 方便 地 对 不 同 的 上 下 文 执行 同一 段 代码 了 。 


例 5-43 用 vm 把 代码 编译 成 脚本 对 象 


> Var vm = tequire('vm') ; 

> Var ES = eduice( ESs ) 

> var code = fs.readFileSync('example.js'); 
> code.tostring(); 


console.1log (output);\n' 
Es 
> var Script = vm.createScript (code); 
> script.runInNewContext ({output:"Kick Ass"}); 
ReferenceError: console is not defined 
at undefined:;1;1 
at [object Context]:1:8 
at Interface.<anonymous> (repl.js:171:22) 
at Interface.emit (events.js:64:17) 
at Interface. onbine (readline.Js:153:10) 
at Interface. line (readline.js:408:8) 
at Interface. ttyWrite (readline.js:585:14) 
at ReadStream.<anonymous> (readline.js:73:12) 
at ReadStream.emit (events.js:81:20) 
at ReadStream. emitKey (tty posix.js:307:10) 
> script.runInNewContext ({"console":console, "output":"Kick Ass"})); 
Kick Ass 





这 个 例子 从 一 个 JavaScript 文件 中 读 取 代码 ， 里 面包 含 一 句 简单 的 命令 console . 
log(output);。 我 们 先 把 它 编译 成 一 个 script 对 象 ， 这 样 就 能 对 此 脚本 执行 
script.runInNewContext ()， 并 且 传 人 一 个 上 下 文 。 为 了 演示 ， 我 们 故意 触发 
一 个 错误 。 当 运行 vm.runInNewContext () 时 ， 你 需要 传 入 所 引用 的 对 象 (如 
console 对 象 ) ， 否 则 ， 即 使 是 最 基础 的 全 局 函数 也 不 能 使 用 。 还 需要 注意 的 是 ， 
抛 出 异常 的 位 置 是 undefined:1:1。 


所 有 的 vm 运行 命令 都 可 以 把 文件 名 作为 可 选 的 最 后 一 个 参数 。 它 不 会 改变 其 功能 ， 
但 是 允许 你 设置 出 现 错误 时 在 消息 里 想 要 显示 的 文件 名 字 。 如 果 你 从 磁盘 加 载 并 运 
行 了 许多 文件 ， 这 个 功能 就 很 有 帮助 ， 因 为 它 能 够 告诉 你 哪个 代码 出 现 了 错误 。 该 
参数 是 完全 随意 的 ， 因 此 你 可 以 采用 任何 有 助 于 调试 的 字符 串 作 为 参数 。 
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与 其 他 Web 服务 器 类 似 ，Node 需要 通过 存储 来 进行 数据 持久 化 。 离 开 了 持久 化 ， 
你 的 网 站 就 只 是 一 个 宣传 性 质 的 静态 站 点 ， 也 就 没有 必要 使 用 Node 了 。 在 本 章 中 ， 
我 们 会 讲 到 如 何 连 接 常 见 的 开源 数据 库 ， 以 及 如 何 保存 和 读 取 数据 。 


6.1 NoSQL 和 文档 存储 


下 面 介 绍 的 这 儿 个 NoSQL 数据 库 和 文档 存储 系统 在 Web 应 用 开发 领域 越 来 越 受 欢 
迎 ， 而 且 与 Node 结合 起 来 使 用 非常 地 简单 。 








6.1.1 CouchDB 


CouchDB 提供 了 JavaScript 环境 下 基于 MVCC 的 文档 存储 。 在 CouchDB 里 面 添 加 
或 修改 文档 (记录 ) 时， 整个 数据 集 都 会 保存 到 存储 上 ， 并 且 把 老 的 版 本 标记 为 过 
时 的 。 该 记录 的 老 版 本 内 容 依 然 会 被 整合 到 最 新 的 版 本 里 面 去 。 每 当 创建 了 一 个 完 
整 的 新 版 本 时 ， 都 会 写 入 到 连续 的 内 存 中 ， 以 便于 更 快 地 读 取 。 因 此 CouchDB 被 
称 为 “最 终 一 致 性 ”。 在 大 型 的 、 可 扩展 部 署 中 ， 多 个 实例 有 时 会 把 较 老 (未 同步 ) 
的 记录 发 送 给 客户 端 ， 但 对 记录 的 所 有 修改 最 终 会 合并 到 主 实例 中 。 


1. 安装 


女 衣 











并 非 某 个 特定 版 本 的 CouchDB 库 才 能 访问 数据 库 ， 但 有 些 库 提供 了 更 高 级 的 抽象 ， 








注 1: MVCC 是 多 版 本 并 发 控制 (multi-version concurrency control) 的 缩写 。 
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并 能 使 代码 操作 起 来 更 为 简便 。 我 们 还 需要 安装 一 个 CouchDB 的 服务 器 来 测试 示 
例 代 码 ， 这 其 实 很 容易 完成 。 


(1) 安装 CouchDB。 最 新 版 本 的 CouchDB 可 以 从 Apache 项 目 主页 下 载 http:/ 
couchdb.apache.org/download.html， 不 同 平台 的 安装 指导 也 能 在 其 wiki 页 面 http:// 
wiki.apache.org/couchdby/installation 上 找到 。 


如 果 你 使 用 的 是 Windows， 除 了 按 提示 的 方法 从 源 代码 编译 外 ， 还 可 以 找到 二 进 制 
安装 包 。 与 其 他 许多 NoSQL 产品 一 样 ， 在 Linux 这 类 系统 上 安装 是 最 容易 的 ， 而 
且 支 持 得 更 好 ， 但 你 也 可 以 另外 选择 自己 熟悉 的 系统 。 


(2) 安装 CouchDB 的 Node 模块 。 使 用 CouchDB 并 不 是 必须 用 额外 的 模块 ， 因 为 
CouchDB 通过 REST 方式 把 它 所 有 的 服务 都 开放 了 ， 后 面 会 详细 介绍 。 





2. 通过 HTTP 使 用 CouchDB 


CouchDB 的 一 大 优点 是 ， 它 的 API 真 的 全 都 是 HTTP 接口 。 因 为 Node 能 够 很 好 地 
使 用 HITP， 所 以 它 使 用 CouchDB 也 非常 容易 。 正 因为 这 个 原因 ， 我 们 可 以 直接 对 
数据 库 操作 ， 而 不 需要 借助 于 其 他 客户 端 。 


例 6-1 演示 了 如 何在 当前 安装 的 CouchDB 中 生成 一 个 数据 库 列表 。 在 这 个 例子 里 ， 
并 没有 对 CouchDB 服务 器 进行 身份 验证 或 管理 权限 的 限制 。 这 对 连接 在 互联 网 上 
的 数据 库 来 说 绝 不 是 个 好 主意 ， 但 如 果 单 纯 用 于 演示 的 目的 ， 还 是 可 以 的 。 

例 6-1 通过 HTTP 获取 CouchDB 的 数据 库 列表 


var http = require('http'); 














http.createServer (function (req, res) { 
Var client = http.createClient (5984, "127.0.0.1"); 
var request = client.request ("GET", "/ all dbs"); 
request .end(); 


request.on("response", function(response) { 


var responseBody = ""; 


response.on("data", function (chunk) { 
responseBody += chunk; 


}); 


response.on("end", function() { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.write (responseBody); 
res.end(); 
}); 
}s 


}) .listen(8080); 





客户 端的 连接 是 用 http 库 创建 的 ， 这 与 其 他 的 http 连接 并 没有 区 别 。 因 为 
CouchDB 是 RESTful 的 接口 ， 所 以 不 需要 额外 的 传输 协议 。 需 要 注意 的 是 ， 
request .end() 这 行 代码 是 在 createservez 方 法 内 部 执行 的 。 如 果 缺 少 了 这 行 
代码 ， 请 求 会 被 挂 起 。 





如 前 所 述 ， 所 有 的 CouchDB 方法 都 是 HTTP 调用 的 。 因 此 ， 创 建 和 删除 数据 库 分 
别 是 通过 向 服务 器 提交 相应 的 PUT 和 DELETE 语句 来 实现 的 , 见 例 6-2。 


例 6-2 创建 CouchDB 数据 库 


var client = http.createClient (5984, "127.0.0.1") 
Var request = client.request ("PUT", "/dbname"); 
request .end () ; 


request.on("response", function(response) { 
response.on("end", function() { 
if ( response.statusCode == 201 ) { 
console.log("Database successfully created."); 
} else { 


console.log("Could not create database."); 


ys 
和 
在 这 里 /abname 指 代 的 是 需要 访问 的 资源 。 配 合 一 个 PUT 命令， 就 是 告诉 
CouchDB 要 创建 一 个 新 的 数据 库 ， 名 字 叫 dabname。 返 回 的 HTTP 二 201 表示 数 
据 库 创 建成 功 。 





如 例 6-3 所 示 ， 删 除 资源 用 的 是 PUT 的 反 操 作 : DELETE 命令 。HTTP 返回 代码 
200 确认 了 该 请 求 已 成 功 执行 。 


例 6-3 删除 CouchDB 数据 库 


var client = http.createClient (5984, "127.0.0.1") 
Var request = client.request ("DELETE", "/dbname"); 
request .end () ; 





request.on("response", function(response) { 
response.on("end", function() { 
if ( response.statusCode == 200 ) { 
console.log("Deleted database."); 
} else { 


console.log("Coulgd not delete database."); 


] ) ; 
] ) ; 


这 些 元 素 单独 使 用 并 没有 多 大 意义 ， 但 把 它们 组 合 起 来 ， 就 能 够 作为 一 个 基本 的 数 
据 库 管理 工具 了 (虽然 不 是 特别 好 用 )， 它 使 用 的 方法 如 例 6-4 中 所 示 。 
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例 6-4 一 个 简单 的 创建 CouchDB 数据 库 的 方式 


var http = require('http'); 


Var qs = require('querystring'); 
Var url = require('url'); 
var dHost s "127.0.0.1"., 


Var dbPort = 5984; 


deleteDb = function(res, dbpath) { 
var client = http.createClient (dbPort, dbHost) 
Var request = client.request ("DELETE", dbpath); 
request .end () ; 


request.on("response", function(response) { 
response.on("end", function() { 
if ( response.statusCode == 200 ) { 
ShowDbs (res, "Deleted database."); 
} else { 


showDbs (res, "Could not delete database."); 


createDb = function(res, dbname) { 
var client = http.createClient (dbPort, dbHost) 
Var request = client.request ("PUT", "/" + dbname); 


request .end () ; 


request.on("response", function(response) { 
response.on("end", function() { 
if ( response.statusCode == 201 ) { 
ShowDbs (res, dbname + " created."); 
} else { 
showDbs (res, "Could not create " + dbname); 


showDbs = function(res, message) { 
var client = http.createClient (dbPort, dbHost); 
var request = client.request ("GET", "/ all dbs"); 


request .end () ; 


request.on("response", function(response) { 
var responseBody = ""; 


response.on("data", function (chunk) { 
responseBody += chunk; 


} ys 


response.on("end", function() { 


res.writeHead(200, {'Content-Type': 'text/html'}); 
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res.write("<form method='post'>"); 

res.write("New Database Name: <input type='text' name='dbname' />"); 
res.write("<input type='submit' />"); 

res.write("</form>"); 

if ( null != message ) res.write("<hl>" + message + "</h1l>"); 


res.write("<hl>Active databases:</h1l>"); 
res.write("<ul>"); 
var dblist = JSON.parse (responseBody); 
for (i= 0; i < dblist.length; i++ ) { 
var dbname = dblist[i]; 
res.write("<li><a href='/" + dbname + "'>"+dbname+"</a></1i>"); 


} 


res.write("</ul>"); 
res.end(); 


http.createServer (function (reqg, res) { 


if ( req.method == 'POST' ) { 
// 解析 请 求 
var body = ''; 
req.on('data', function (data) { 


body += data; 

和 

req.on('end', function () { 
var POST = qs.parse (body); 
Var dbname = POST['dbname']; 





if ( null != dbname ) { 
// 创建 数据 库 
createDb (res, dbname); 
} else { 
showDbs (res, "Bad DB name, cannot create database."); 
} 
3 
} else { 
var path = url.parse (req.url) .pathname; 
i ( Bath la T/A Y 4 
deleteDb (res,path)，; 
} else { 


showDbs (res); 
} 
} 


}) .listen(8080); 
3. 使 用 node-couchdb 
知道 如 何 用 HTTP 来 使 用 CouchDB 是 很 有 用 的 ， 但 这 个 方法 太 过 繁琐 。 虽 然 说 不 
需要 额外 库 是 它 的 优势 ， 但 即便 数据 库 的 原生 驱动 实现 起 来 非常 简单 ， 大 多 数 程序 


员 依 然 倾 向 于 使 用 更 高 抽象 级 的 工具 。 在 本 小 节 ， 我 们 会 看 一 下 node-couchdb 包 ， 
它 会 简化 Node 与 CouchDB 间 的 接口 。 
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使 用 npm 来 安装 CouchDB 的 驱动 : 


npm install felix-couchdb 
(1) 使 用 数据 库 。 使 用 这 个 模块 的 第 一 个 显著 好 处 就 是 代码 更 简洁， 如 例 6-5 所 示 。 
例 6-5 在 CouchDB 中 创建 一 个 表 


dp. 
i 
} 


} 
a 


dbiost. = "127.0,.0.1"; 

dbPort = 5984; 

dbName = 'users'; 

couchdb = require('felix-couchdb')，; 

client = couchdb.createClient (dbPort, dbHost); 
db = client.db (dbName); 


exists (function(err, exists) { 
£f (lexists) { 
db.create(); 


console.log('Database ' + dbName + ' created.'); 
else { 
console.log('Database ' + dbName + ' exists.'),; 


这 个 例子 检查 了 是 否 有 个 数据 库 叫 users， 如 果 不 存在 则 创建 一 个 新 的 。 注 意 这 里 
调用 的 createCclient 函数 与 之 前 使 用 http 模块 演示 的 函数 有 些 相似 。 这 不 是 偶 
然 的 ， 因 为 即使 使 用 了 更 便捷 的 CouchDB 模块 ， 到 最 后 你 还 是 要 使 用 HTTP 来 传 





输 数 据 。 
(2) 创建 文档 。 在 例 6-6 中 , 我 们 会 在 之 前 例子 创建 的 CouchDB 数据 库 中 保存 一 个 
文档 。 
例 6-6 在 CouchDB 中 创建 一 个 文档 
var OpbEoast ss "127.0.0.1"; 
var dbPort = 5984; 
Var dbName = 'users'; 


var couchdb = require('felix-couchdb'); 
var client = couchdb.createClient (dbPort, dbHost); 
var user = { 

name: { 


} 
} 


Var 


flrest: JOkmY.; 
last: 'Doe' 


db = client.db (dbName); 


db.saveDoc('jdoe', user, functionl(err, doc) { 





if( err) { 
console.1log(JSON.stringify(err)); 
} else { 
console.log('Saved user.'); 


} 
和 


这 个 例子 创建 了 一 个 用 户 ， 名 为 John Doe， 并 以 用 户 名 jdoe 作为 标识 保存 在 数据 库 
里 。 注 意 ，user 是 一 个 JSON 对 象 ， 并 且 直 接 传 给 了 客户 端 ， 不 需要 其 他 工作 来 解 
析 这 些 信 息 。 


运行 了 这 个 例子 后 ， 该 用 户 信息 可 以 在 浏览 器 里 通过 http://127.0.0.1:5984/users/jdoe 
访问 。 

(3) 读 取 文档 。 文 档 一 旦 保存 在 了 CouchDB 里 ， 就 可 以 以 对 象 的 方式 读 取 ， 如 例 
6-7 所 示 。 








例 6-7 从 CouchDB 取 回 一 条 记录 


Yar biogst sas TL27.00, 1 
Var dbPort = 5984; 
Var dbName = 'users'; 


Var couchdb = require('felix-couchdb'); 
var client = couchdb.createClient (dbPort, dbHost); 


var db = client.db (dbName).; 
db.getDoc('jdoe', function(err,doc) { 
console.1log(doc); 
}); 
i Dg 
查询 的 输出 内 容 是 
{ _id: 'jdoe', 


_rev: '3-67a7414d073c9ebce3d4af0a0e49691d',， 
name: { first: 'John', last: 'Doe' } 


这 里 分 为 如 下 3 步 执行 。 
(a) 使 用 createclient 连接 到 数据 库 。 
(b) 用 客户 端的 ab 命令 选择 文档 存储 库 








(c) 用 数据 库 的 getDoc 命令 获取 文档 。 


在 这 个 例子 里 ，ID 为 jdoe 的 记录 (之 前 例子 中 创建 的 ) 从 数据 库 中 取 回 。 如 果 记 录 
不 存在 (因为 它 被 删除 了 或 者 没有 插入 )， 回 调 函 数 的 error 参数 会 包含 错误 信息 。 
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(4) 更 新 文档 。 更 新 文档 使 用 的 是 与 创建 文档 一 样 的 saveDoc 命令 。 如 果 CouchDB 
检测 到 有 同样 ID 的 记录 存在 ， 它 会 把 旧 的 记录 覆盖 。 


例 6-8 演示 了 如 何 从 数据 存储 中 读 取 一 个 文档 然后 更 新 它 。 
例 6-8 在 CouchDB 中 更 新 一 条 记录 


var OHEOSE ss "127.0.0.1"; 
var dbPort = 5984; 
Var dbName = 'users'; 














Var couchdb = require('felix-couchdb'); 
var client = couchdb.createClient (dbPort, dbHost); 


var db = client.db (dbName); 


db.getDoc('jdoe', function(err,doc) { 
doc.name.first = 'Johnny'; 
doc.email = 'jdoe@johndoe.com'; 


db.saveDoc('jdoe', doc ); 


db.getDoc('jdoe', function(err,revisedUser) { 
console.log(revisedUser); 
二 
}) ; 
本 操作 的 输出 为 : 


{ _id: 'jdoe', 
_rev: '7-lfb9a3bb6db27cbbbflc74b2d601lccaa', 
name: { first: 'Johnny', last: 'Doe' }, 
email: 'jdoe@johndoe.com' 


} 


这 个 例子 从 数据 存储 中 读 取 关于 jdoe 用 户 的 信息 ， 增 加 了 一 个 email 地 址 和 新 的 
first name， 然 后 保存 回 CouchDB。 


注意 在 第 一 次 读 取 数 据 之 后 的 saveDoc 和 getDoc 操作 ，getDoc 并 不 是 放 在 
saveDoc 的 回调 函数 里 。 因 为 CouchDB 驱动 会 把 命令 保存 在 队列 里 ， 然 后 顺 
序 执 行 ， 所 以 这 个 例子 不 会 出 现 竞争 状态 ， 即 在 保存 更 新 之 前 就 先 完 成 了 文档 读 取 








(5) 删除 文档 。 要 从 CouchDB 里 删除 文档 ， 需 要 同时 提供 ID 和 版 本 号 。 好 在 从 读 
取 操 作 里 很 容易 得 到 这 些 信息 ， 见 例 6-9。 


例 6-9 在 CouchDB 中 进行 删除 


VAar GbHost = 127.0.0, 7 





var dbpPport 
var dbName 


5984; 
'users'; 


Var couchdb = require('felix-couchdb'); 
var client = couchdb.createClient (dbPort, dbHost); 


var db = client.db (dbName).; 


db.getDoc('jdoe', function(err,doc) { 
db.removeDoc (doc. id, doc. rev); 


} 
连接 上 CouchDB 数据 存储 后 ， 这 里 调用 了 getDoc 命令 ， 用 来 获得 内 部 ID ( ia) 


和 版 本 号 (_rev)。 一 旦 这 些 信息 都 拿 到 了 ， 就 可 以 调用 removeDoc 命令 ， 它 会 发 
送 一 个 DELETE 请 求 给 数据 库 。 


6.1.2 Redis 

Redis 是 基于 内 存 的 key-value 存储 ， 并 具备 了 持久 化 功能 。 如 果 你 有 使 用 key-value 
缓存 (如 Memcache) 的 经 验 ， 这 会 让 你 党 得 很 熟悉 。Redis 在 性 能 和 扩展 性 要 求 
很 高 的 情况 下 会 被 使 用 。 在 多 数 情况 下 ， 开 发 人 员 用 它 作 为 从 关系 型 数据 库 (如 
MySQL) 中 读 取 数据 的 缓存 ， 但 它 能 提供 的 功能 其 实 很 多 。 

除了 key-value 的 存储 能 力 ，Redis 还 提供 了 可 供 网 络 访问 的 共享 内 存 、 非 阻塞 的 事 
件 总 线 ， 还 有 订阅 和 发 布 的 功能 。 

1. 安装 
和 许多 其 他 的 数据 库 类 似 ， 使 用 Redis 需要 先 安装 它 的 数据 库 应 用 程序 和 与 它 连 接 
的 Node 驱动 。 





漆 





(1) 安装 Redis。Redis 是 以 源 代码 的 方式 提供 的 (http://redis.io/download)。 配 置 起 
来 并 不 需要 做 太 多 的 工作 ， 只 要 下 载 并 按照 网 站 的 指示 进行 编译 就 可 以 了 。 

如 果 你 使 用 的 是 Windows， 就 要 自己 另外 想 办 法 了 ， 因 为 目前 Redis 官方 并 不 支持 
在 Windows 上 运行 。 幸 好 ，Redis 开发 社区 里 一 帮 热 心 的 支持 者 把 Redis 移植 到 了 
Windows 上 ， 比 如 使 用 Cygwin 或 者 原生 的 编译 版 本 。 你 可 以 在 https://github.com/ 
dmajkic/redis 上 找到 用 MinGW 编译 的 原生 Windows 二 进 制 文件 。 








(2) 安装 Redis 的 Node 模块 。redis 模块 可 以 从 GitHub 找到 (https://github.com/ 
mranney/node_redis) ， 也 可 以 用 npm 工具 来 安装 : 


npm install redis 


或 者 ， 除 了 安装 Node 的 redis 模块 之 外 ， 还 可 以 安装 更 简约 的 niredis 库 。 





数据 访问 | 117 


2. 基本 功能 
例 6-10 演示 了 通过 Node 对 Redis 进行 基础 的 set 和 get 操作 。 


例 6-10 Redis 里 基础 的 get 和 set 操作 


var redis = require('redis'), 
client = redis.createClient () ; 
client.on("error", function (err) { 


console.log("Error " + err); 


})s 


console.log("Setting key1"); 
client.set ("keyl", "My string!", redis.print); 
console.log("Getting key1") ; 
client.get("keyl"，function (err, reply) { 
console.log("Results for keyl:"); 
console.log(reply); 
client.end(); 


}ys 


个 例子 先 创建 了 一 个 Redis 数据 库 的 连接 ， 并 且 设 置 了 处 理 错误 的 回调 函数 。 如 
果 你 没有 运行 Redis 服务 器 ， 就 会 得 到 类 似 下 面 这 样 的 错误 : 





Error Error: Redis connection to 127.0.0.1:6379 failed - ECONNREFUSED, 
Connection refused 

注意 ， 这 个 例子 里 缺少 了 一 些 回调 函数 。 如 果 需 要 在 数据 库 写 入 操作 之 后 
ye 马上 读 取 ， 就 应 该 使 用 更 安全 的 方法 一 一 回调 函数 ， 这 样 才能 确保 代码 按 
上 照 正确 的 顺序 执行 。 











在 连接 打开 之 后 ， 客 户 端 设置 了 一 个 基本 数据 ,然后 从 数据 库 中 把 这 些 值 读 回来 。 
库 提供 了 与 Redis 基本 命令 一 样 的 函数 (set、hset、get)。Redis 把 set 命令 传 
输 过 来 的 数据 作为 字符 串 使 用 ， 人 允许 最 大 到 512 MB 。 


3. 哈 希 


哈 希 是 包含 多 个 key 的 对 象 ， 例 6-11 中 每 次 设置 了 一 个 key 的 内 容 。 








例 6-11 每 次 设置 一 个 hash 值 


var redis = require('redis'), 
client = redis.createClient () ; 
client.on("error", function (err) { 


console.log("Error " + err); 


}) ; 


console.log("Setting user hash") ; 





client.hset ("user", "username", "johndoe"); 
client.hset ("user", "firstname", "john"); 
client.hset ("user", "lastname", "doe");，; 


client.hkeys ("user", function (err,replies) { 
console.log("Results for user:"); 
console.log(replies.length + " replies:"); 
replies.forEach (function (reply, i) { 
console.log(i + ": " + reply ); 
Ds 


client.end(); 


}s 
例 6-12 演示 了 如何 一 次 设置 多 个 key 的 内 容 。 


例 6-12 同时 设置 多 个 hash 值 


Var redis = require('redis'), 
client = redis.createClient (); 
client.on("error", function (err) { 


console.log("Error " + err); 


Ds 


console.log("Setting user hash"); 
client.hmset ("user", "username", "johndoe", "firstname", "john", 
"lastname", "doe"); 


client.hkeys ("user", function (err,replies) { 
console.log("Results for user:"); 
console.log(replies.length + " replies:"); 
replies.forEach (function (reply, i) { 
console.log(i + ": " + reply ); 
})s 


client.end(); 


] ) ; 
当然 ， 我 们 可 以 采用 一 种 对 程序 员 更 加 友好 的 方式 来 完成 同样 的 功能 ， 使 用 一 个 对 
象 ， 而 不 是 把 每 个 key、value 拆 成 列表 ， 如 例 6-13 所 示 。 
例 6-13 使 用 对 象 来 设置 多 个 hash 值 


Var redis = require('redis'), 
client = redis.createClient (); 





client.on("error", function (err) { 
console.log("Error " + err); 


}); 


var user = { 
username: 'johndoe', 
firstname: 'John', 
lastname: 'Doe', 
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email: 'john@johndoe.com', 
website: 'http://www.johndoe.com' 


} 


console.log("Setting user hash") ; 
client.hmset ("user", user); 


client.hkeys ("user", function(err,replies) { 
console.log("Results for user:"); 
console.log(replies.length + " replies:"); 
replies.forEach (function (reply, i) { 
console.log(i + ": " + reply ); 
} 


client.end(); 


ys 


除了 可 以 手动 把 每 一 项 都 提供 给 Redis， 你 还 可 以 把 整个 对 象 传 入 hmset， 它 会 把 
内 容 解析 出 来 并 将 正确 的 信息 发 送 到 Redis 服务 器 





需要 注意 ， 添 加 多 个 内 容 对 象 时 ， 使 用 的 是 hmset 而 不 是 hset。 这 里 有 
一 E>》 个 常见 的 错误 ， 就 是 会 忘记 一 个 对 象 其 实 包含 了 多 个 值 。 











4. 列表 


可 以 将 列表 类 型 想象 成 一 个 key 包含 了 多 个 值 ( 见 例 6-14) 。 因 为 可 以 往 列 表 的 头 
部 和 尾部 都 添加 内 容 ， 所 以 这 些 集合 很 适合 用 来 展示 有 序 事件 ， 比 如 记录 那些 用 户 
最 近 获 得 了 某 项 宁 誉 。 


例 6-14 在 Redis 中 使 用 列表 


Var redis = Teduire (Pedis’), 
client = redis.createClient (); 
client.on("error", function (err) { 
console.log("Error " + err); 
}ys 
client.lpush("pendingusers", "user1" ) ; 
client.lpush("pendingusers", "user2" ) ; 
client.lpush("pendingusers", "user3" ) ; 
client.lpush("pendingusers", "user4" ) ; 
client.rpop("pendingusers", function(err,username) { 
if( !err ) { 


console.log("Processing " + username); 


} 


client.end(); 





例子 的 输出 是 : 
Processing userl 


个 例子 演示 了 用 Redis 的 1ist 命令 实现 一 个 先入 先 出 队列 (FIFO)。 现 实 中 注册 
PO te ee rn madi 注册 信息 会 被 
转移 到 队列 中 去 ， 以 便 在 主 程序 外 处 理 。 注 册 请 求 会 按照 接收 的 顺序 处 理 ， 但 主 程 
序 不 会 因为 需要 处 理 真 正 的 创建 记录 和 介绍 工作 (如 发 送 欢 迎 邮 件 ) 而 变 慢 。 








5. 集合 
当 需 要 一 个 没有 重复 内 容 的 列表 时 ， 使 用 集合 ， 如 例 6-15 所 示 。 


例 6-15 使 用 Redis set 命令 


Var redis = require('redis'), 
client = redis.createClient () ; 


client.on("error", function (err) { 
console.log("Error " + err); 


] ) ; 


client.sadd( "myteam", "Neil" ) 
client.sadd( "myteam", "Peter" ) 
client.sadd( "myteam", "Brian" ); 
client.sadd( "myteam", "Scott" ); 
client.sadd( "myteam", "Brian" ) 


client.smembers( "myteam", functionl(err, members) { 
console.log( members ); 
client.end(); 


Py 


输出 是 : 

[ 'Brian', 'Scott', 'Neil', 'Peter' ] 
i te 它 也 只 会 被 插入 一 次 。 在 实际 中 ， 完 全 可 能 出 现 两 
个 成 员 都 叫 Brian 的 情 ; tg 


A 比如 你 得 到 的 数量 少 于 预期 ， 是 因为 把 重复 的 项 目 移 
除了 。 


6. 有 序 集合 


和 普通 集合 一 样 ， 有 序 集合 也 不 允许 重复 成 员 。 有 序 集合 增加 了 权重 的 概念 ， 允 许 
在 数据 上 进行 基于 分 数 的 操作 ， 比 如 排行 榜 、 最 高 分 和 内 容 表 。 


美国 减肥 真人 秀 节 目 《 超 级 减肥 王 》(7The Biggest Loser) 的 制作 方 真是 有 序 集合 的 
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粉丝 。 在 系列 第 11 季 中 ， 比 赛 选手 根据 他 们 的 年 龄 被 分 为 3 组 。 在 直播 中 ， 选 手 们 
ee 二 原始 的 排序 ， 在 烈日 下 按 升序 站 成 一 列 。 如 

其 中 一 个 选手 带 上 装备 Node 及 Redis 的 笔记 本 到 比赛 现场 ， 他 就 可 以 写 个 小 程序 
ee 案 了 ， 如 例 6-16 所 示 。 


例 6-16 使 用 Redis 来 进行 列表 排序 


var redis = require('redis'), 
client = redis.createClient () ; 
client.on("error", function (err) { 


console.log("Error " + err); 


7 


client.zadd 


client.zadd( "contestants", 60, "Deborah" ); 
client.zadd( "contestants", 65, "John" ); 
client.zadd( "contestants", 26, "Patrick" ); 
client.zadd( "contestants", 62, "Mike" ); 
client.zadd( "contestants", 24, "Courtney" ) ; 
client.zadd( "contestants", 39, "Jennifer" ); 
client.zadd( "contestants", 26, "Jessica" ); 
client.zadd( "contestants", 46, "Joe" ); 
client.zadd( "contestants", 63, "Bonnie" ); 
client.zadd( "contestants", 27, "Vinny" ); 
client.zadd( "contestants", 27, "Ramon" ) ; 
client.zadd( "contestants", 51, "Becky" ); 
client.zadd( "contestants", 41, "Sunny" ) ; 
client.zadd( "contestants", 47, "Antone" ); 

( 


"contestants", 40, "John" ); 


client.zcard( "contestants", function( err, length ) { 
if( !err ) { 
Var contestantCount = length,; 


Var membersPerTeam = Math.ceil( contestantCount / 3 ); 
client.zrange( "contestants", membersPperTeam * 0, membersPperTeam * 1 - 1, 
functionl(err, values) { 
console.log('Young team: ' + Values) ; 
2 
client.zrange( "contestants", membersPperTeam * 1, membersPperTeam * 2 - 1, 
functionl(err, values) { 


console.log('Middle team: ' + Values) ; 
的 学 
Client .zzrange( "contestants", membersPerTeam * 2, contestantCount, 
function(err, values) { 
console.log('Elder team: ' + Values) ; 


client.end(); 





Middle team: Jennifer,John,Sunny,Joe,Antone 
Elder team: Becky,Deborah,Mike,Bonnie 

















往 有 序 集合 添加 成 员 的 方法 和 普通 集合 的 操作 方法 一 样 ， 但 需要 增加 一 项 权重 ,这 
样 可 以 很 容易 地 做 分 割 ， 如 例子 中 所 示 。 te eden ne 要 从 
一 个 排序 列表 中 得 到 3 个 队伍 ， 只 要 从 集合 中 直接 抽取 3 个 相等 的 组 就 行 了 。 因 为 
比赛 选手 的 数量 (14) 并 不 能 被 3 整除 ， 因 此 最 后 一 组 只 有 4 个 成 员 。 





7. 订阅 


Redis 支持 发 布 - 订 阅 (pub-sub) 消息 模型 ， 允 许 发 送 者 (发布 者 ) 往 频道 里 添加 
消息 ， 然 后 由 匿名 的 接收 者 (订阅 者 ) 使 用 ( 例 6-17)。 订 阅 者 注册 他 们 感 兴趣 的 
领域 (频道 )，Redis 就 会 把 相关 的 消息 推送 给 他 们 。 发 布 者 不 需要 注册 到 特定 的 频 
道 ， 或 者 在 发 送 的 时 候 不 需要 有 监听 的 订阅 者 。Redis 会 做 好 中 间 商 ， 这 提供 了 很 
大 的 便利 ， 因 此 发 布 者 和 订阅 者 无 需 知道 对 方 的 信息 。 
例 6-17 使 用 Redis 订阅 与 发 布 

var redis = require("redis"), 


talkativeClient = redis.createClient(), 
pensiveClient = redis.createClient ()，; 





pensiveClient.on("subscribe", function (channel, count) { 
talkativeClient.publish( channel, "Welcome to " + channel ); 
talkativeClient.publish( channel, "You subscribed to " + count + " 


channels!" );，; 

] ) ; 

pensiveClient.on("unsubscribe", function(channel, count) { 
于 下 (count ‘saa 0) 4 


talkativeClient .end(); 
pensiveClient .end(); 
} 
ps 


pensiveClient.on("message'", function (channel, message) { 

console.log(channel + ': ' + message); 
}y 
pensiveClient.on("ready", function() { 

pensiveClient.subscribe("quiet channel", "peaceful channel", "noisy 
channel™ ) ; 

setTimeout (Eunction() { 

PensiveClient .unsubscribe("dquiet channel", "peaceful channel", "noisy 

channel™ );，; 

}, 1000); 


}s 
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结果 是 : 


quiet channel: Welcome to quiet channel 

quiet channel: You subscribed to 1 channels! 
peaceful channel: Welcome to peaceful channel 
peaceful channel: You subscribed to 2 channels! 
noisy channel: Welcome to noisy channel 

noisy channel: You subscribed to 3 channels! 


这 个 例子 列举 了 两 个 客户 端的 情况 ， 一 个 是 安静 且 考 虑 周到 的 ， 而 另 一 个 会 把 它 周 
围 的 信息 广播 给 任何 一 个 听众 。 深 沉 的 客户 端 订 阅 了 3 个 频道 ，quiet、peaceful 和 
noisy， 健 谈 的 客户 端 为 每 个 订阅 者 都 发 送 欢 迎 来 到 该 频道 的 信息 ， 并 记录 了 当前 活 
跃 订 阅 数 。 

在 订阅 一 秒 之 后 ， 深 沉 的 客户 端 取 消 了 所 有 3 个 频道 的 订阅 。 当 unsubscribe 命 
令 检 查 到 没有 任何 活跃 订阅 的 时 候 ， 两 个 客户 端 都 断 开 了 与 Redis 的 连接 ， 并 且 退 
出 程序 。 


8. Redis 安全 性 





Redis 支持 密码 验证 。 要 添加 密码 ， 需 要 编辑 Redis 的 配置 文件 ， 增 加 一 名 
requirepass， 如 例 6-18 所 示 。 


例 6-18 ”Redis 密码 配置 例子 


## 并 提 社 提 守 并 提 扩 提 守 提 守 提 村 扩 提 扩 提 守 提 提 社 提 失 提 提 坟 提 圭 # SECURITY 失 提 守 提 提 提 提 社 提 失 提 检 扩 提 社 提 守 提 村 扩 术 提 守 寺 提 社 提 提 间 六 

# Require clients to issue AUTH <PASSWORD> before processing any other 

tH# commands. This might be useful in environments in which you do not 
yh aa bh 

# others with access to the host running redis-server. 

六 

# This should stay commented out for backward compatibility and because 
most 

# People do not need auth (e.g., they run their own servers). 

# 





requirepass hidengoseke 


一 旦 Redis 重启 ， 它 就 只 会 对 使 用 hidengoseke 作为 密码 授权 的 客户 端 服务 了 ( 例 
6-19) 。 


例 6-19 登录 Redis 


var redis = require('redis'), 
client = redis.createClient (); 


client.auth("hidengoseke"); 








auth 命令 必须 在 其 他 操作 之 前 执行 。 客 户 端 会 保存 密码 ， 并 且 在 重新 连接 的 时 候 
使 用 。 


注意 这 里 没有 用 户 名 或 多 个 密码 。Redis 并 没有 提供 用 户 管理 功能 ， 因 为 这 会 增加 
开销 。 因 此 ， 期 望 系统 管理 员 能 够 用 其 他 方法 保护 好 他 们 的 服务 器 ， 比 如 把 Redis 
的 端口 从 外 界 隔 离开 ， 只 让 可 靠 的 用 户 在 内 部 访问 。 

一 些 “ 和 危险 ”的 命令 可 以 改名 或 者 彻底 移 除 。 比 如 ， 你 可 能 永远 都 不 会 使 用 
CONFIG 命令 。 在 这 种 情况 下 ， 可 以 修改 配置 文件 ， 要 么 把 它 改 名 为 其 他 安全 的 名 
称 ， 要 么 把 它 禁 用 以 避免 不 希望 的 使 用 。 这 两 个 方法 都 在 例 6-20 中 展示 出 来 。 

例 6-20 将 Redis 命令 改名 


# Change CONFIG command to something obscure 
rename-command CONFIG 923jfiosflkja98rufadskjgfwefu89awtsga09nbhsdalkjf3p49 











# Clear CONFIG command, so no one can use it 
rename-command CONFIG "" 


6.1.3 MongoDB 


为 Mongo 提供 了 JavaScript 环境 下 的 BSON 对 象 存储 (一 种 JSON 的 二 进 制 变 
种 )， 因 此 从 Node 去 读 写 数据 都 非常 高 效 。Mongo 把 传 入 的 数据 保存 在 内 存 里 ， 
此 很 适合 高 并 发 写 操作 的 情况 。 它 的 每 个 新 版 本 都 不 断 提高 了 集群 、 复 制 和 分 片 的 
功能 。 

为 写 入 的 数据 保存 在 内 存 中 ， 所 以 往 Mongo 插入 数据 是 非 阻塞 的 ， 因 此 也 很 适 
合用 来 记录 操作 和 远程 数据 。Mongo 支持 在 查询 里 诅 入 JavaScript 函数 ， 还 能 进行 
MapReduce 查询 ， 所 以 读 取 数据 的 时 候 功 能 也 很 强大 。 


使 用 MongoDB 的 文档 型 存储 ， 你 可 以 把 子 记 录 保 存在 母 记录 的 内 部 。 比 如 ， 一 篇 
博客 及 其 相关 的 所 有 评论 都 能 保存 在 一 条 记录 里 ， 这 样 读 取 起 来 就 非常 快 。 








1.MongoDB 原生 驱动 


Christian Kvaleim 编写 的 原生 MongoDB 驱动 (https://github.com/christkv/node- 
mongodb-native ) 提供 了 访问 MongoDB 的 非 阻塞 方式 。 之 前 的 版 本 提供 了 C/C++ 的 
BSON 解析 器 和 序列 化 功能 ， 但 因为 JavaScript 版 本 的 性 能 提高 ， 所 以 这 套 老 的 模 
块 被 弃 用 了 。 


原生 MongoDB 驱动 的 好 处 是 ， 你 可 以 用 来 精确 地 控制 MongoDB 连接 的 操作 。 
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(1) 安装 。 要 安装 此 驱动 ， 需 要 运行 以 下 的 命令 


npm install mongodb 











-ey mongodb 是 为 了 避免 与 后 面 要 使 用 的 mongo 混淆 。 








(2) 数据 类 型 。Node 的 MongoDB 驱动 支持 的 数据 类 型 列 在 表 6-1 中 。 

































































表 6-1: MongoDB 支 持 的 数据 类 型 
类 型 描 述 例 子 
Array 数据 列表 scardsInHand: [9,4,3] 
Boolean | 真 / 假 条 件 hasBeenRead: false 
Code 一 段 能 在 数据 库 中 执行 |new BSON.Code('function quotient( dividend, divisor ) 
的 JavaScript 代码 { return divisor == 0 ? 0 : divident / divisor; }'); 
Date 表示 当前 日 期 和 时 间 lastUpdated: new Date() 
DBRef 数据 库 引 用 * bestFriendId: new BSON.DBRef ('users', 
friendObjectId) 
Integer 一 个 整数 ( 非 十 进 制 ) 数 |pagevViews: 50 
Long 一 个 长 整 型 值 starsInUniverse = new BSON.Long(10000000000000000 
000000000); 
Hash 一 个 键 值 字典 userName: {'first': 'Sam', 'last': 'Smith'} 
Null 一 个 空 值 bestFriend: null 
Object ID | MongoDB 用 来 索引 对 象 |myRecordId: new BSON.ObjectId() 
的 12byte 代码 ， 表 示 24 
位 16 进 制 字符 囊 
String 一 个 JavaScript 字符 串 fullName: 'Sam Smith' 


米 


(3) 与 

















因为 MongoDB 是 非 关 系 型 数据 库 ， 所 以 它 并 不 支持 join 操作 。 数 据 类 型 DBRef 是 客户 端 用 来 实现 
逻辑 关系 join 的 。 


写 入 记录 。 正 如 前 面 所 说 ， 往 MongoDB 集合 中 写 入 记录 需要 在 Node 中 创建 一 








个 JSON 对 象 ， 然 后 直接 往 Mongo 中 打印 进去 。 例 6-21 演示 了 如 何 创建 一 个 用 户 


对 象 ， 


例 6 





并 将 其 保存 到 MongoDB 里 。 
-21 连接 到 MongoDB 并 写 入 一 条 记录 


var mongo = require('mongodb'); 

var host = "localhost"; 

var port = mongo.Connection.DEFAULT PORT; 

var db = new mongo.Db('node-mongo-examples', new mongo.Server (host, port, 


{}), {}); 


db.open (function(err,db) { 
db.collection('users', functionl(err,collection) { 
collection.insert ({username:'Bilbo',firstname:'Shilbo'}, function (err, 
docs) { 





console.log(docs); 
db.close(); 

Py 
}); 

} 


输出 是 : 


[ { username: 'Bilbo', 
firstname: 'Shilbo', 
dl: 4e9cd8204276d9f91a000001 } ] 


2. Mongoose 


Node 使 用 Mongoose 库 能 够 支持 大 量 的 Mongo 操作。 与 原生 的 驱动 相 比 ， 
Mongoose 是 一 个 表达 更 加 清楚 的 环境 ， 让 模型 和 架构 更 加 直观 。 


(1) 安装 。 最 快捷 地 安装 和 运行 Mongoose 的 方法 是 用 npm 来 安装 它 : 
npm install mongo 


或 者 ， 你 可 以 从 源 代 码 下 载 到 最 新 的 版 本 ， 然 后 按照 Mongoose 项 目 主页 (http:// 
mongoosejs.com) 的 方法 来 编译 。 


(2) 定义 结构 (schema)。 使 用 MongoDB 的 时 候 ， 不 需要 像 关系 数据 库 那 样 定义 数 
据 的 结构 。 每 当 需 求 变更 或 者 需要 保存 新 的 信息 时 ， 只 要 把 包含 新 信息 的 记录 保存 
进去 ， 就 能 马上 查询 使 用 了 。 你 可 以 把 旧 数 据 转换 成 新 的 字段 ， 包 含 默 认 值 或 为 空 
值 ， 但 MongoDB 并 不 要 求 这 样 做 。 


虽然 结构 对 于 MongoDB 来 说 并 不 重要 ,但 它 有 助 于 人 们 理解 数据 的 内 容 ， 并 包含 
了 该 领域 数据 的 操作 规则 。Mongoose 的 作用 在 于 ， 它 使 用 了 人 可 读 的 结构 描述 ， 提 
供 了 简洁 的 数据 库 交 互 接口 。 


什么 是 结构 ? 许多 程序 员 会 想 成 是 定义 数据 结构 模型 的 术语 ， 但 较 少 会 想到 这 些 模 
型 代表 的 底层 数据 库 。SQL 数据 库 中 的 一 张 表 需 要 在 写 人 数据 前 先 创建 好 ， 表 中 的 
每 一 个 字段 都 与 你 的 模型 相 匹配 。 该 结构 〈 指 数据 库 中 模型 的 定义 ) 是 与 你 的 程序 
分 别 创建 的 ， 因 此 结构 先 于 数据 存在 。 


人 们 常 说 MongoDB (及 其 他 NoSQL 数据 库 ) 是 无 结构 的 ， 因 为 它 不 要 求 显 式 地 定 
义 存 储 数 据 的 数据 结构 。 实 际 上 ，MongoDB 是 有 结构 的 ， 但 并 不 由 它 保存 的 数据 
所 决定 。 你 可 以 在 程序 运行 了 几 个 月 后 对 模型 增加 新 的 属性 ， 但 不 必 重 新 为 之 前 已 
经 保存 的 数据 定义 结构 ， 就 能 对 新 的 字段 进行 查询 。 
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例 6-22 演示 了 如 何 为 一 个 文章 数据 库 定义 样 例 结构 ， 以 及 每 种 模型 的 类 型 该 如 何 保 
存 信息 。 再 次 说 明 ，Mongo 并 不 强制 执行 结构 ， 但 程序 员 需 要 在 自己 的 程序 里 定义 
统一 的 访问 模式 。 








例 6-22 用 Mongoose 定义 结构 


Var mongoose = require('mongoose') 


var Schema = mongoose.Schema, 
ObjectId = Schema.ObjectId 


var AuthorSchema = new Schema ({ 


name: { 
下 二 记名 已 1 EPInG.: 
last : StELng; 
EW : String 
}, 
contact: { 
email + EPIng.: 
twitter : String; 
google : String 
}, 
photo SEELng 
] 
var CommentSchema = new Schema ({ 
commenter : String, 
body SEELNG; 
posted : Date 
})s 
var RArticleSchema = new Schema({ 
author : ObjectId， 
title :StrELng; 
contents : String, 
published : Date, 
comments : [CommentSchemal 


Var Author = mongoose.model('Author', AuthorSschema); 
Var Article = mongoose.model('Article', ArticleSschema); 


(3) 操作 集合 (collection) 。Mongoose 允许 直接 操作 对 象 数 据 集 合 ， 如 例 6-23 所 示 。 


例 6-23 用 Mongoose 读 写 记录 


mongoose .connect ('mongodb://localhost:27017/upandrunning', function(err){ 
if (err) { 
console.log('Could not connect to mongo'); 
} 
}); 


newAuthor.save (function(err) { 





128 | 第 6 章 


if (err) { 
console.log('Could not save author ' ) ; 
} else { 
console.log('Author saved'); 
} 
和 有 


RAuthor .find(function(erzr,dqoc){ 
console.1log(doc); 


9s 
这 个 例子 在 数据 库 里 保存 了 一 条 作者 信息 ， 然 后 把 所 有 作者 在 屏幕 上 打印 出 来 。 
(4) 性 能 。 使 用 Mongoose 的 时 候 ， 你 不 需要 自己 维护 MongoDB 的 连接 ， 因 为 所 
有 的 结构 定义 和 查询 都 会 被 缓存 起 来 ， 直 到 真 的 连接 使 用 。 这 点 很 重要 ， 这 也 是 
Mongoose 提供 Node 服务 的 重要 方法 。 通 过 一 次 性 把 所 有 “正在 执行 的 ”命令 提交 
到 Mongo， 你 可 以 限制 使 用 时 间 ， 减 少 需要 处 理 的 回调 函数 ， 从 而 大 大 提升 程序 能 
够 进行 的 操作 的 数量 。 


6.2 天 系 型 数据 库 


我 们 有 许多 的 理由 依旧 使 用 传统 的 SQL 数据 库 ， 而 Node 对 流行 的 开源 数据 库 都 有 
模块 支持 。 




















6.2.1 MySQL 


MySQL 成 为 开源 世界 的 主力 军 是 有 原因 的 : 它 免 费 提供 了 与 大 型 商用 数据 库 一 样 
的 众多 功能 。 当 前 ，MySQL 拥有 很 高 的 性 能 和 丰富 的 功能 。 





1. 使 用 NodeDB 


node-db 模块 提供 了 常用 数据 库 系 统 的 原生 代码 接口 ， 包 括 与 MySQL 的 接口 。 它 
通过 该 模块 公开 的 通用 API 来 给 Node 使 用 。 虽 然 node-db 不 止 支持 MySQL 一 家 ， 
但 本 闻 将 集中 讲述 如 何在 应 用 代码 中 使 用 MySQL。 自 从 Oracle 收购 了 Sun 公司 ， 
MySQL 及 其 社区 的 未 来 走向 已 受到 很 多 猜测 。 有 些 组 织 主张 迁移 到 直接 替代 品 ， 
如 MariaDB ， 或 者 是 彻底 更 换 到 其 他 的 关系 型 数据 库 管 理 系统 (RDBMS)。 虽 然 
MySQL 不 会 很 快 消 失 ， 但 你 需要 判断 它 是 否 是 工作 的 最 佳 选择 。 








(1) 安装 。MySQL 客户 端 开发 库 是 Node 数据 库 模块 必 选 的 依赖 项 。 在 Ubuntu， 你 
可 以 使 用 apt 命令 安装 这 些 库 : 








sudo apt-get install libmysqlclient-dev 
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然后 使 用 npm 来 安装 名 为 db-mysql 的 包 : 
npm install -g db-mysql 


要 运行 本 部 分 的 示例 代码 ， 需 要 运行 一 个 名 为 upandrunning 的 数据 库 ， 并 且 提 供 
个 账号 ， 其 用 户 名 和 密码 都 是 dev。 以 下 的 脚本 会 创建 基本 的 数据 库 表 和 结构 : 





DROP DATABASE IF EXISTS upandrunning; 


CREATE DATABASE upandrunning; 





GRANT ALL PRIVILEGES ON upandrunning.* TO 'dev'@'%' IDENTIFIFED BY 'dev'; 
USE upandrunning; 


CREATE TABLE users( 
id int auto increment primary key, 
user login varchar (25) ， 
user nicename varchar (75) 


J 


(2) 选择 。 例 6-24 演示 了 如 何 从 WordPress 用 户 表 中 选 出 所 有 的 ID 和 user name 
列 的 内 容 。 


例 6-24 从 MySQL 选 出 数据 
Var mysql = require( 'db-mysql' ); 


var connectParams = { 
'hostname': 'localhost', 
'user': 'dev', 
'password': 'dev', 
'database': 'upandrunning' 


} 


Var db = new mysql.Database( connectParams ) ; 


db.connect (function(error) { 
if ( error ) return console.log("Failed to connect"),; 


this.query () 
“Select(['id', "wser. login"™]) 
.from('users') 
.execute (function(error, rows, columns) { 
if ( error ) { 
console.1log ("Error on query"); 
} else { 
console.1log (rows); 





你 也 许 能 够 猪 到 ， 这 里 执行 的 效果 等 价 于 SQL 命令 SELECT id, user login 
FROM users。 输 出 为 : 


{ id: 1, user login: 'mwilson' } 


(3) 插入 。 插 入 数据 和 选择 数据 的 方法 类 似 ， 因 为 命令 都 是 以 同样 的 方式 串联 起 来 
的 。 例 6-25 演示 了 如 何 进行 INSERT INTO users ( user login ) VALUES ( 
'newbie'); 的 操作 。 








例 6-25 插入 到 MySQL 中 


var mysql = require( 'qb-mysdql' ) 


var connectParams = { 
'hostname': 'localhost', 
'user': 'dev', 
'password': 'dev', 
'database': 'upandrunning' 


} 
var db = new mysql.Database( connectParams ); 


db.connect (function(error) { 


if ( error ) return console.log("Failed to connect"); 
this.query () 
.insert('users', ['user login'], ['newbie']) 
.execute (function(error, rows, columns) { 
if ( error ) { 


console.log ("Error on query"); 
console.log (error); 


} 


else console.1log (rows); 


输出 是 : 
{ id: 2, affected: 1, warning: 0 } 
.insert 命令 接受 下 列 3 个 参数 。 
。 表 的 名 称 。 
。 待 插入 列 的 名 称 。 
。 插入 每 列 的 对 应 值 。 


数据 库 驱 动 会 处 理 好 转 义 ， 并 把 数据 类 型 转换 成 列 需 要 的 值 。 所 以 你 不 需要 在 传 给 
这 个 模块 的 代码 上 担心 SQL 注入 攻击 。 
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(4) 更 新 。 与 选择 和 插入 一 样 ， 更 新 操作 也 是 依赖 链 式 函数 来 生成 等 价 的 SQL 操作 。 
例 6-26 展示 的 是 使 用 查询 条 件 来 限定 更 新 的 目标 ， 而 不 是 对 整个 数据 库 表 的 所 有 记 
录 都 作 精 心 修改 。 


例 6-26 在 MySQL 中 更 新 数据 


Var mysql = require( 'db-mysql' ); 





var connectParams = { 
'hostname': 'localhost', 
'user': 'dev', 
'password': 'dev', 
'database': 'unandrunning' 
} 


Var db = new mysql.Database( connectParams ); 


db.connect (function(error) { 
if ( error ) return console.log("Failed to connect" ) ; 


this.query () 
.update('users') 


.set({'user nicename': 'New User' }) 
.where('user login = ?', [ 'newbie' ]) 
.execute (function(error, rows, columns) { 
if ( error ) { 


console.log("Error on query"); 
console.log(error); 


} 


else console.log (rows); 
})s 
}) ; 


输出 是 : 
{ id: 0, affected: 1, warning: 0 } 
更 新 一 行 数据 包含 下 面 3 个 部 分 。 
。 .update 命令 ， 接 受 表 名 (本 例 为 users) 作为 参数 。 


。 .set 命令 , 使 用 key-value 对 象 来 确定 哪 一 列 需要 修改 ， 以 及 它们 的 新 值 是 多 少 。 
。 .where 命令 ， 告 诉 MySQK 该 如 何 过 滤 需 要 修改 的 记录 。 


(5) 删除 。 如 例 6-27 所 示 ， 删 除 与 更 新 非常 类 似 ， 唯 一 的 不 同 是 ， 在 删除 的 时 候 ， 
不 需要 指定 哪 一 列 有 更 新 。 如 果 没 有 指定 where 条 件 ， 那 么 整个 表 的 数据 都 将 被 删 
除 干净 。 


例 6-27 从 MySQL 中 删除 数据 


Var mysql = require( 'db-mysql' ); 








var connectParams = { 


'hostname': 'localhost', 
'user': 'dev', 

'password': 'dev', 
'database': 'upandrunning' 


} 
Var db = new mysql.Database( connectParams ); 


db.connect (function(error) { 


if ( error ) return console.log("Failed to connect"); 
this.query() 
.delete() 
.from('users') 
.where('user login = ?', [ 'newbie' ]) 
.execute (function(error, rows, columns) { 
if ( error ) { 


console.log("Error on query"); 
console.log (error); 


} 


else console.log (rows); 
}); 
})s 


输出 是 : 
{ id: 0, affected: 1, warning: 0 } 


.delete 命令 和 .update 命令 类 似 ， 了 唯一 的 不 同 是 它 不 接受 任何 列 的 名 字 和 数据 。 
在 这 个 例子 里 ，where 条 件 里 使 用 了 通配符 : 'user_ login = ?'。 代码 中 的 问号 
会 被 user_ login 参数 替换 掉 ， 然 后 再 执行 。 第 二 个 参数 是 个 数组 ， 因 为 如 果 使 用 
了 多 个 问号 ， 数 据 库 驱动 就 需要 从 这 个 参数 中 按 顺 序 取 值 使 用 。 





2. Sequelize 


Sequelize 是 一 个 对 象 关系 映射 (ORM)， 它 把 之 前 部 分 介绍 的 重复 工作 简化 了 。 你 
可 以 使 用 Sequelize 来 定义 数据 库 与 程序 间 共 享 的 对 象 ， 这 样 就 不 需要 为 每 个 操作 写 
查询 语句 ， 而 是 直接 通过 操作 这 些 对 象 来 写 入 或 读 取 数据 库 。 当 你 在 进行 维护 或 者 
增加 新 数据 列 的 时 候 ， 这 绝对 能 市 省 不 少时 间 ， 而 且 能 在 整个 数据 管理 工作 中 减少 


错误 。Sequelize 支持 通过 npm 安装 : 








npm install sequelize 


上 一 小 节 的 例子 中 已 经 创建 好 了 数据 库 和 示例 用 户 ， 现 在 是 时 候 在 数据 库 里 创建 
Author 实体 了 ( 例 6-28) 。Sequelize 替 你 处 理 了 创建 操作 ， 所 以 此 时 不 需要 手动 执 
行 任何 SQL 操作 。 
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例 6-28 用 Sequelize 创建 实例 


var Sequelize = require('sequelize'); 


var db = new Sequelize('upandrunning', 'dev', 'dev', { 
host: "Localhost'" 


} 


var Author = db.define('Author', { 
name: Sedquelize.STRING， 
biography: Sequelize.TEXT 


}); 


Author.sync() .on('success', function() { 
console.log('Author table was created.'); 
}) .on('failure', function(error) { 


console.log('Unable to create author table'); 


和 这 





输出 是 : 
Executing: CREATE TABLE IF NOT EXISTS ‘Authors' (‘name' VRARCHAR (255) ， 
‘biography' 
TEXT, ‘id' INT NOT NULL auto increment , ‘createdAt' DATETIME NOT NULL, 
‘updatedAt. 
DATETIME NOT NULL, PRIMARY KEY (‘id' )) ENGINE=INnnoDB; 


Author table was created. 


在 本 例 中 ，Author 被 定义 为 一 个 包含 了 name 字段 和 biograph 字段 的 实例 。 在 输 
出 中 能 够 看 见 ，Sequelize 添加 了 一 个 自 增 的 主键 列 、creategdAt 列 和 updatedAt 
列 。 这 是 许多 ORM 采用 的 典型 方法 ， 提 供 了 标准 化 的 接口 让 Sequelize 能 够 关联 和 
处 理 你 的 数据 。 


Sequelize 与 本 章 之 前 介绍 的 库 有 所 区 别 ， 它 是 基于 监听 事件 驱动 的 架构 ， 而 不 是 其 
他 地 方 采用 的 回调 函数 驱动 的 架构 。 这 意味 着 ， 你 需要 在 每 个 操作 之 后 同时 监听 成 
功 和 失败 事件 ， 而 不 是 在 操作 返回 值 中 包含 成 功 或 失败 的 信息 。 


例 6-29 创建 了 多 对 多 关系 的 两 个 表 ， 操 作 的 顺序 如 下 。 
(1) 设置 实例 的 结构 。 

(2) 把 结构 (schema) 与 真实 的 数据 库 进行 同步 。 

(3) 创建 并 保存 一 个 Book 对 象 。 

(4) 创建 并 保存 一 个 author 对 象 。 




















(5) 建立 author 和 book 之 间 的 关系 。 





例 6-29 用 Sequelize 保存 记录 和 关系 


var Sequelize = require('sequelize'),，; 


var db = new Sequelize('upandrunning', 'dev', 'dev', { 
host: 'localhost' 


}ys 


var Author = db.define('Author', { 
name: Sequelize.STRING, 
biography: Sequelize.TEXT 


}); 


var Book = db.define('Book', { 
name: Sequelize.STRING 


和 


Author .hasMany (Book) ; 
Book .hasMany (Author); 


db.sync() .on('success', function() { 
Book .build({ 
name: 'Through the Storm' 
}) .save().on('success', function(book) { 
console.log('Book saved'); 
Author.build({ 
name: 'Lynne Spears', 
biography: 'Author and mother of Britney' 
}) .save().on('success', function(record) { 
console.log('Author saved.'); 
record.setBooks ( [book] ) ; 
record.save() .on('success', function() { 
console.log('Author & Book Relation created'); 
局 
有 更 
}) .on('failure', function(error) { 
console.log('Could not save book'); 
站 
}) .on('failure', function(error) { 
console.log('Failed to Sync database'); 


] ) ; 
为 了 确保 所 有 的 实例 都 设置 正确 ， 需 要 在 等 待 book 成 功 保存 到 数据 库 之 后 再 创建 
author。 同 样 ， 在 author 成 功 保存 到 数据 库 之 后 ，book 才能 被 添加 到 author 
上 。 这 样 确保 了 Sequelize 能 够 取 到 author 和 book 的 ID， 并 且 建 立 它们 之 间 的 关 
系 。 输 出 如 下 : 


ttt 











Executing: CREATE TABLE IF NOT EXISTS ‘AuthorsBooks' 
(‘BookId' INT , ‘AuthorId' INT , ‘createdAt' DATETIME NOT NULL, 
‘updatedAt' DATETIME NOT NULL, 





PRIMARY KEY (‘BookId' , ‘AuthorId' )) ENGINE=INnoDB; 
Executing: CREATE TABLE IF NOT EXISTS ‘Authors' 
(‘name' VARCHAR(255), ‘biography' TEXT， 
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‘id' INT NOT NULL auto increment , ‘createdAt' DATETIME NOT NULL, 
‘updatedAt' DATETIME NOT NULL, PRIMARY KEY (‘id' )) 
ENGINE=InnoDB; 


















































Executing: CREATE TABLE IF NOT EXISTS ‘Books' 
(‘name' VARCHAR(255), ‘id' INT NOT NULL auto increment ， 
‘createdAt' DATETIME NOT NULL, ‘updatedAt' DATETIME NOT NULL, 
PRIMARY KEY (‘id' )) ENGINE=InnoDB ; 
Executing: CREATE TABLE IF NOT EXISTS ‘AuthorsBooks' 
(‘BookId' INT , ‘AuthorId' INT , ‘createdAt' DATETIME NOT NULL, 
‘updatedAt' DATETIME NOT NULL, 
PRIMARY KEY (‘BookId' , ‘AuthorId' )) ENGINE=InnoDB ; 
Executing: INSERT INTO ‘Books' (‘name' ,'id' , ‘createdAt' , ‘updatedAt' ) 





VALUES ('Through the Storm',NULL,'2011-12-01 20:51:59', 
'2011-12-01 20:51:59'); 
Book saved 
Executing: INSERT INTO ‘Authors' (‘name' , ‘biography' , ‘id' , ‘createdAat' 
‘up datedat' ) 
VALUES ('Lynne Spears','Author and mother of Britney', 
NULL, '2011-12-01 20:51:59','2011-12-01 20:51:59'); 
Author saved. 


Executing: UPDATE ‘Authors' SET ‘name' ='‘'Lynne Spears' ， 
‘biography' = ‘Author and mother of Britney' , ‘id' =3, 
GreatedAt ="2011-12-01 -2035515917 
‘updatedAt' ='2011-12-01 20:51:59' WHERE ‘id' =3 


Author & Book Relation created 

Executing: SELECT * FROM ‘AuthorsBooks' WHERE ‘AuthorId' =3; 

Executing: INSERT INTO ‘AuthorsBooks' (‘AuthorId' , ‘BookId' , ‘createdAt',，, 
‘u pdatedAt') 
VALUES (3,3,'2011-12-01 20:51:59','2011-12-01 20:51:59'); 





6.2.2 PostgreSQL 

PostgreSQL 是 面向 对 象 的 RDBMS， 诞 生 于 加 州 大 学 伯克利 分 校 。 其 前 身 是 Ingres 
数据 库 ，Michael Stonebraker 教授 是 该 项 目的 发 起 者 及 领 尖 人 。 从 1985 年 到 1993 
年 ，Postres 团队 发 布 了 该 软件 的 4 个 版 本 。 在 项 目 接近 尾声 时 ， 越 来 越 多 的 用 户 开 
始 支持 此 项 目 ， 同 时 提出 了 大 量 新 功能 需求 ， 也 使 开发 团队 面临 着 巨大 压力 。 在 伯 
克利 团队 开发 之 后 ， 开 源 社 区 的 开发 者 接管 了 该 项 目 ， 把 原来 的 QUEL 语言 解析 器 
改 为 SQL 语言 解析 器 ， 并 将 项 目 改 名 为 PostgreSQL。 自 从 1997 年 PostgreSQL 发 
布 了 第 一 个 版 本 PostgreSQL 6.0， 该 数据 库 系 统 就 作为 功能 强大 的 发 行 版 赢得 了 良 
好 的 声誉 ， 对 于 有 Oracle 背景 的 用 户 来 说 尤其 方便 好 用 。 




















1. 安装 





可 用 于 产品 线 的 PostgreSQL 版 本 (已 经 被 Yammer.com 这 样 的 大 型 网 站 使 用 ) 可 
以 从 npm 资源 库 下 载 ， 如 下 : 





npm install pg 








这 需要 先 安 装 bg_config， 你 可 以 通过 1ibpq-dev 包 找 到 它 。 














2. 选择 


例 6-30 假设 你 已 经 创建 了 一 个 叫做 upandrunning 的 数据 库 并 且 授 予 了 daev 用 户 
(密码 也 是 sev) 权限 。 


例 6-30 从 PostgreSQL 选 出 数据 


Var pg = require('pg'); 


var connectionSstring = "pg://dev:dev@localhost:5432/upandrunning"; 
pg.connect (connectionSstring, function(err, client) { 
if (err) { 
console.log( err ); 


} else { 
var sqlStmt = "SELECT username, firstname, lastname FROM users"; 
client.dquery( sqlStmt, null, function(err, result) { 
if ( err ) { 
console.log(err); 
} else { 


console.log(result); 


} 


pg.end(); 
})s 
} 
好 


输出 是 : 
{ rows: 
[ { username: 'bshilbo', 


firstname: 'Bilbo', 
lastname: 'Shilbo' } ] } 


这 与 MySQL 驱动 的 链 式 调用 方法 有 很 大 区 别 。 使 用 PostgreSQL 的 时 候 ， 它 会 要 你 
直接 编写 SQL 查询 语句 。 


如 上 述 例子 所 示 ， 调 用 ena () 函数 会 关闭 连接 ， 结 束 Node 事件 循环 。 





3. 插入 、 更 新 和 删除 


当 手 工 输入 SQL 查询 语句 时 ， 你 可 能 倾向 于 直接 把 数据 值 通过 字符 串 连接 操作 扔 在 
代码 里 ， 但 聪明 的 程序 员 会 寻求 方法 来 保护 自己 不 被 SQL 注入 攻击 。pg 库 接 受 参 
数 形式 的 查询 ， 这 样 就 能 够 用 上 来 自 外 部 资源 (比如 网 页 的 表单 ) 里 的 值 。 例 6-31 
演示 了 如 何 插入 ， 例 6-32 和 例 6-33 示范 的 是 更 新 和 删除 。 
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例 6-31 插入 到 PostgreSQL 


Var pg = require('pg'); 


Var connectionSstring = "pg://dev:dev@localhost:5432/upandrunning"; 
pg.connect (connectionSstring, function(err, client) { 
if (err) { 
console.log( err ) ; 


} else { 
Var sqlSstmt = "INSERT INTO users( username, firstname, lastname ) "; 
sqlStmt += "VALUES ( $1, $2, $3)"; 
var sqlParams = ['jdoe', 'John', 'Doe']; 
var query = client.query( sqlStmt, sqlParams, function(err, result) { 
if ( err ) { 
console.log (err); 
} else { 
console.log(result); 
} 
pg.end(); 
六 
} 
过 
输出 是 : 
{ rows: [], command: 'INSERT', rowCount: 1, oid: 0 } 


query 命令 以 SQL 语句 作为 第 一 个 参数 ， 第 二 个 参数 是 一 个 数据 值 的 数组 。MySQL 
驱动 使 用 问号 作为 参数 值 替换 标记 ， 而 PostgreSQL 使 用 的 是 序号 参数 。 能 够 为 参数 
排 号 有 利于 你 更 好 地 控制 数值 的 组 织 方 式 。 


例 6-32 在 PostgreSQL 中 更 新 数据 


var pg = require('pg'); 


Var connectionSstring = "pg://dev:dev@localhost:5432/upandrunning"; 
pg.connect (connectionSstring, function(err, client) { 
if (err) { 
console.log( err ) ; 
} else { 
var sqlStmt 


"UPDATE users " 


+ "SET firstname = $1 " 
+ "WHERE username = $2"; 
var sqlParams = ['jane', 'jdoe']; 
var query = client.query( sqlStmt, sqlParams, function(err, result) { 
if (err ) { 
console.log(err); 
} else { 
console.log(result); 
} 


pg.end();，; 
})); 
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例 6-33 从 PostgreSQL 中 删除 数据 


var pg = require('pg'); 


var connectionSstring = "pg://dev:dev@localhost:5432/upandrunning"; 
pg.connect (connectionstring, function(err, client) { 
i = 
console.log( err ); 


} else { 
var sqlStmt = "DELETE FROM users WHERE username = $1"; 
var sqlParams = ['jdoe']; 
var query = client.dquery( sqlStmt, sqlParams, function(err, result) { 
if ( err ) { 
console.log(err); 
} else { 


console.log(result); 


} 
pg.end();，; 
和 
} 
} ) ; 


6.3 连接 池 

生产 环境 通常 由 多 种 资源 组 成 : Web 服务 器 、 缓 存 服务 器 和 数据 库 服务 器 。 数 据 库 
通常 是 部 署 在 Web 服务 器 之 外 的 独立 机 器 上 ， 这 使 得 面向 公众 的 网 站 不 必 重 新 配置 
和 修改 复杂 的 数据 库 集 群 就 可 以 垂直 增长 。 因 此 应 用 开发 程序 员 需 要 留心 访问 这 些 
资源 时 的 性 能 实现 情况 ， 以 及 这 些 访问 开销 会 如 何 影响 网 站 的 表现 。 


连接 池 在 Web 开发 中 是 非常 重要 的 概念 ， 因 为 建立 一 个 数据 库 连接 的 开销 相对 来 说 
还 是 很 大 的 。 为 每 个 请 求 创建 一 个 其 至 多 个 连接 会 对 高 流量 网 站 造成 不 必要 的 额外 
人 负担， 也 会 导致 性 能 下 降 。 解 决 方案 是 在 内 部 缓存 池 里 维护 数据 库 连 接 ， 当 茶 连 接 
不 再 需要 时 ， 它 会 被 放 回 连接 池 里 ， 这 样 就 能 立刻 为 下 一 个 进入 的 请 求 服务 了 。 


许多 数据 库 驱 动 提供 了 连接 池 功 能 ， 但 该 模式 违反 了 Node 的 “一 个 模块 ， 一 个 
功能 ”的 理念 。 所 以 ，Node 开发 者 在 数据 层 之 上 应 使 用 通用 的 连接 池 (generic- 
pool) 模块 来 进行 数据 库 连 接 服务 ( 例 6-34)。 generic-pool 模块 会 重用 已 有 的 连 
接 ， 尽 可 能 地 防止 因为 创建 新 的 数据 库 连 接 而 带 来 的 开销 ， 而 且 这 个 模块 可 以 用 在 
任何 数据 库 上 。 


例 6-34 使 用 node-db 的 连接 池 


var mysql = require( 'db-mysqgl' ) 
Var poolModule = require('generic-pool'); 












































var connectParams = { 
'hostname': 'localhost', 
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'user': 'dev', 
'password': 'dev', 
'database': 'zZborowski' 


var pool = poolModule.Pool({ 
name : 'mysqgl', 
create : function(callback) { 
Var db = new mysql.Database( connectParams ) ; 
db.connect (function(error) { 
callback (error, db); 


}); 
i 
destroy : function(client) { client.disconnect (); }, 
max 0 


idleTimeoutMillis : 3000, 
log : true 


}s 


pool.acquire (function(error, client) { 
if ( error ) return console.log("Failed to connect"),; 


client .query () 
"Select (['id'; user: 10gin"]) 
.from('wp_users') 
.execute (function(error, rows, columns) { 


if ( error ) { 
console.1og("Error on query"); 
} else { 
console.1log (rows); 
} 


pool.release (client); 
De: 
}ys 


输出 为 : 


pool mysql - dispense() clients=1 available=0 

pool mysql - dispense() - creating obj - count=1 

[ { id: 1, user login: 'mwilson' } ] 

pool mysql - timeout: 1319413992199 

pool mysql - dispense() clients=0 available=1 

pool mysql - availableObjects.length=1 

pool mysql - availableObjects.length=1 

pool mysql - removeIdle() destroying obj - now:1319413992211 
timeout:1319413992199 

pool mysql - removeIdle() all objects removed 


连接 池 通 过 神奇 的 创建 (create) 和 销毁 (destroy) 函数 来 工作 。 当 客户 尝试 歼 
取 一 个 连接 时 ， 如 果 没 有 已 经 打开 的 连接 ， 连 接 池 会 调用 创建 函数 。 如 果 一 个 连接 
闲置 太 久 了 (由 idqleTimeoutMillis 属性 来 指定 空间 间 隔 ， 以 毫秒 来 计算 )， 它 会 
被 销毁 并 且 释 放 内 存 资源 。 
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Node 连接 池 的 优雅 之 处 在 于 ， 它 可 以 表示 任何 持久 化 的 资源 。 选 择 数据 库 可 谓 得 天 
独 厚 ， 同 时 你 也 可 以 轻松 地 写 些 命令 来 维护 与 外 界 资源 〈 如 会 话 缓存 ， 甚 至 是 硬件 
接口 ) 的 连接 。 


6.4 消息 队列 协议 

之 前 ， 我 们 举 了 邮递 员 的 例子 来 描述 Node 的 事件 循环 架构 。 如 果 邮 递 员 碰 到 哪 家 
关 了 门 ， 他 就 无 法 继续 投递 信件 了 。 想 象 一 下 ， 如 果 有 一 名 好 心 的 老 门 卫 能 够 把 门 
打开 ， 让 邮递 员 通 过 呢 ? 但 是 门卫 已 经 上 了 年 纪 ， 且 因为 服务 多 年 而 身体 虚弱 ， 他 
需要 多 花 点 时 间 才 能 清理 道路 ， 因 此 这 段 时 间 内 邮递 员 暂 时 无 法 继续 投递 信件 。 


这 就 类 似 堵 塞 的 进程 ， 但 这 种 状况 不 会 一 直 持 续 。 最 终 ， 门 卫 会 把 门 打开 ， 然 后 邮 
递 员 又 能 继续 他 的 业务 了 。 如 果 邮 递 员 到 达 的 每 一 个 屋子 都 有 类 似 的 开门 进程 ， 会 
把 整个 通道 都 拖 慢 。 在 Node 程序 里 ， 这 类 堵塞 将 严重 降低 系统 性 能 。 


在 计算 机 领域 ， 造 成 类 似 情 况 的 原因 很 多 ， 可 能 是 因为 在 注册 过 程 中 需要 发 送 用 户 
邮件 ， 需 要 对 用 户 输入 进行 大 量 的 数学 运算 ， 或 者 是 某 个 任务 需要 花费 的 时 间 超 过 
了 用 户 期 望 的 等 待 时 间 ， 等 等 。Node 的 事件 驱动 设计 可 用 来 应 对 大 多 数 情况 ， 它 采 
用 的 是 异步 函数 和 回调 的 方法 。 但 是 如 果 一 个 事件 特别 “ 重 ” 的 话 ， 就 不 应 该 放 在 
Node 内 部 处 理 。Node 应 该 只 负责 快速 运算 和 处 理 返 回 的 结果 。 


以 一 个 普通 的 用 户 注 册 流 程 为 例 。 当 用 户 自己 注册 时 ， 应 用 程序 会 在 数据 库 中 保存 
一 条 新 的 记录 ， 并 发 送 邮 件 给 该 用 户 。 它 也 许 还 会 记录 下 注册 过 程 中 的 一 些 统计 数 
据 ， 比 如 整个 过 程 包括 了 几 个 步 了 又、 花费 了 多 少时 间 。 如 果 用 户 刚 在 你 的 网 页 上 点 
击 提交 按钮 ， 系 统 就 马上 处 理 那 么 多 的 操作 ， 其 实 并 没有 太 大 意义 。 比 如 ， 发 送 邮 
件 的 流程 也 许 需要 花费 几 秒 钟 (如果 你 运气 不 佳 ， 要 花 上 几 分 钟 ) 来 完成 ， 数 据 库 
调用 可 以 等 到 用 户 受到 欢迎 之 后 再 进行 操作 ， 统 计数 据 可 以 从 程序 的 主 逻 辑 独立 出 
去 处 理 。 这 样 的 情况 下 ， 你 可 以 选择 生成 一 条 消息 ， 来 通知 程序 的 其 他 部 分 有 新 用 
户 注 册 了 ， 这 样 的 程序 也 可 能 是 完全 运行 在 另外 一 台 服 务 器 上 的 。 这 就 是 我 们 所 称 
的 发 布 - 订阅 模型 (publish-subscribe pattern ) 。 

再 假设 你 有 一 个 集群 的 机 器 运行 了 Node.js 程序 。 当 一 台新 机 器 要 加 入 到 集群 的 时 
候 ， 它 发 出 一 条 信息 来 请 求 配 置信 息 。 配 置 服务 器 返回 的 信息 包含 了 新 机 器 整合 到 
集群 中 所 需要 的 配置 信息 列表 ， 这 称 为 请 求 -回复 模型 (request-reply pattern ) 。 
消息 队列 允许 程序 员 发 布 事件 然后 继续 其 他 操作 ， 通 过 进程 间 通 信和 频道 ， 提 高 了 并 
发 处 理 的 效率 ， 并 实现 了 更 高 的 扩展 性 。 
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RabbitMQ 

RabbitMQ 是 一 个 消息 代理 ， 支 持 高 级 消息 队列 协议 (AMQP)。 它 适用 的 情景 有 跨 
服务 器 的 数据 交换 和 同一 台 服 务 器 上 的 跨 进程 通信 。RabbitMQ 使 用 Erlang 语言 编 
写 ， 能 够 提供 集群 的 高 可 用 性 ， 并 且 很 容易 安装 和 使 用 。 


1. 安装 RabbitMQ 


如 果 你 使 用 Linux 系统 ， 大 部 分 发 行 版 都 提供 了 RabbitMQ 的 安装 包 。 你 也 可 以 从 

http://www.rabbitmq.com 下 载 此 软件 ， 然 后 从 源 代码 编译 。 

一 旦 安装 好 了 RabbiiMQ， 并 启动 起 来 ， 就 可 以 使 用 npm 来 获得 Node 的 AMQP 驱动 : 
npm install amqp 

2. 发 布 与 订阅 

RabbitMQ 使 用 标准 的 AMQP 协议 进行 通信 。AMQP 源 于 金融 服务 行业 ， 在 金融 领 

域 消 息 的 可 靠 性 关系 重大 。AMQP 提供 了 对 厂商 中 立 的 抽象 规范 ， 可 以 提供 通用 的 

(不 只 针对 金融 行业 的 ) 消息 中 间 件 服务 ， 并 且 虽 在 解决 不 同类 型 系统 间 通 信 的 问 

题 。AMQP 与 E-mail 的 概念 很 像 :， E-mail 消息 有 其 头 信 息 和 格式 的 规范 ， 但 内 容 可 

以 是 任何 格式 ， 文 本、 图 片 或 视频 都 可 以 ， 两 个 公司 之 间 不 需要 运行 同一 款 E-mail 

服务 器 就 能 通信 。AMQP 还 可 以 在 不 同 平台 间 通 信 。 比 如 ， 用 PHP 编写 的 发 布 者 可 

以 给 用 JavaScript 编写 的 消费 者 发 送 消息 。 























例 6-35 AMQP/RabbitMQ 使 用 方法 


Var connection = require('amqp') .createConnection (); 


connection.on('ready', function() { 
console.log('Connected to ' + connection.serverProperties.product); 
Var e = connection.exchange('up-and-running'); 


var q = connection.queue('up-and-running-queue'); 


q.on('queueDeclareOk', function(args) { 
console.log('Queue opened ' ) ; 
q.bind(e, '#'); 


q.on('queueBindOk', function() { 
console.1log('Queue bound'),; 


q.on('basicConsumeOk', function() { 
console.log("Consumer has subscribed, publishing message."); 
e.publish('routingKey', {hello:'world'}); 


3 





q.subscribe (function(msg) { 
console.log('Message received:'); 
console.1log (msg); 
connection.end(); 


输出 为 : 


Connected to RabbitMO 
Queue opened 
Queue bound 
Consumer has subscribed, publishing message. 
Message received: 
{ hello: 'world' } 
createConnection 命令 建立 了 一 个 到 RabbitMQ 消息 "a 默认 情况 ( 依 


照 AMQP 协议 ) 是 localhost 的 5672 端口 。 如 果 需 要 ， 这 个 命令 可 以 被 重 载 ， 如 ; 


createConnection({host: 'dev.mycompany.com', port: 5555}) 


接 下 来 定义 了 queue 和 exchange。 这 一 步 并 不 是 严格 要 求 的 ， 因 为 AMQP 代理 会 被 
要 求 提供 一 个 默认 的 exchange。 但 是 通过 指定 up-and-running 作为 exchange 的 
名 字 ， 你 可 以 让 程序 与 运行 在 同一 台 服 务 器 上 的 其 他 exchange 隔离 开 。exchange 是 
负责 接收 消息 并 把 它们 传递 给 绑 定 的 队列 的 实体 。 


队列 自己 并 不 会 做 任何 操作 ， 它 必须 绑 定 到 某 个 exchange 之 后 才能 进行 其 他 操作 。 

d.bind(e， '#1) 命令 告诉 AMQP 把 名 为 up-and-running-queue 的 队列 添加 
到 名 为 up-and-running 的 exchange 上 ， 并 有 旦 让 exchange 监听 所 有 传 给 它 的 消息 
(通过 '#' 参数 ) 。 你 可 以 很 方便 地 把 # 改 为 其 他 关键 字 来 过 滤 消 息 


一 旦 声明 好 了 queue 和 exchange， 我 们 就 设置 了 basicconsumeOk 的 事件 监听 ， 当 
客户 端 订阅 了 此 队列 之 后 ，AMQP 库 会 触发 这 个 事件 。 而 后 Node 会 发 布 一 条 hello 
world 消息 ， 以 及 用 来 过 滤 的 关键 词 routingKey 给 exchange。 ee 过 
滤 的 关键 词 是 什么 并 没有 关系 ， 因 为 队列 绑 定 了 所 有 内 容 (通过 pina ('#') 命令 )。 
但 AMQP 的 中 心思 想 是 发 布 者 永远 不 知道 哪些 订阅 者 连接 了 ， 所 以 需 0 个 作为 
路 由 的 关键 词 备 用 。 


最 后 ， 发 送 了 subscribe 命令 。 回 调 函 数 是 作为 参数 传 和 人 的， 并且 每 次 符合 条 件 的 
消息 传 给 exchange 并 通过 queue 传输 之 后 ， 都 会 调用 它 。 在 本 例 中 ， 回 调 函 数 会 导 
致 程序 退出 ， 这 对 于 演示 的 目的 来 说 足够 了 。 但 在 真实 的 应 用 中 ， We 
做 。 当 subscribe 命令 成 功 执行 后 ，AMQP 会 分 发 basicconsumeok 事件 ， 

触发 hello world 消息 的 发 布 ， 然 后 中 断 演示 程序 。 
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3. 工作 队列 


如 果 长 时 间 和 运行 的 任务 超出 了 用 户 的 容忍 度 〈 比 如 等 待 一 个 网 页 加 载 时 ) ， 或 者 是 该 
任务 会 堵塞 整个 程序 ， 使 用 队列 就 很 合适 。 使 用 RabbitMQ， 是 否 可 以 把 任务 分 散 
到 多 个 工作 进程 中 ， 并 确保 所 有 任务 都 能 完成 呢 ? 即使 第 一 个 工作 进程 在 处 理 它 们 
的 时 候 中 途 死 掉 也 行 吗 ? ( 例 6-36) 


例 6-36 用 AMQP 发 布 长 时 间 运 行 任务 


var connection = require('amqp') .createConnection (); 





Var Count ss 0; 

connection.on('ready', function() { 
console.log('Connected to ' + connection.serverProperties.product),; 
var e = connection.exchange('up-and-running'); 


var q = connection.queue('up-and-running-queue'); 


q.on('queueDeclareOk', function(args) { 
console.log('Queue opened'); 
q.bind(e, '#'); 


q.on('queueBindOk', function() { 
console.log('Queue bound'); 


setInterval (function(){ 
console.log('Publishing message #' + ++Count),; 
e.publish('routingKey', {count:count}); 

}, 1000); 


}) ; 
})s 

这 个 例子 是 上 一 节 的 简单 发 布 -订阅 例子 的 修改 版 。 但 它 只 是 一 个 发 布 者 ， 所 以 移 
除了 订阅 相关 的 事件 监听 器 。 代 替 它 的 是 一 个 定时 器 ， 用 来 每 隔 1000 毫秒 ( 即 每 
秒 ) 往 队 列 发 布 一 条 消息 ， 该 消息 包含 了 一 个 count 变量 ， 表 示 每 次 发 布 增加 的 次 
数 。 这 上段 代码 可 以 用 来 实现 一 个 简单 的 工作 者 应 用 。 例 6-37 示范 了 如 何 写 相应 的 客 
户 端 。 
例 6-37 用 AMQP 处 理 长 时 间 运 行 任务 


Var connection = require('amqp') .createConnection (); 


function sleep (milliseconds) 


var start = new Date() .getTime(); 
while (new Date() .getTime() < start + milliseconds); 
connection.on('ready', function() { 





console.log('Connected to ' + connection.serverproperties.product); 


var e 
var qd 


connection.exchange ('up-and-running'); 
connection.queue('up-and-running-queue'); 


dq.on('queueDeclareOk', function(args) { 
q.bind(e,'#'); 


q.subscribe({ack:true},function(msg) { 
console.log('Message received:')，; 
console.log(msg.count); 
sleep(5000); 
console.log('Processed. Waiting for next message.'); 
Le 
}); 
})s 
}); 
客户 端 从 队列 获取 消息 再 处 理 它 (在 这 个 例子 里 是 睡眠 5 秒 )， 然 后 从 队列 获取 下 
一 条 消息 ， 并 不 断 重复 。 虽 然 Node 里 并 没有 sleep 函数 ， 但 你 可 以 用 死 循 环 来 代替 
它 ， 如 例子 所 示 。 


这 里 有 个 问题 。 回 想 一 下 ， 前 面 的 发 布 者 是 每 隔 1 秒 发 送 一 条 消息 到 队列 的 ， 但 因 
为 客户 端 要 花费 5 秒 才能 处 理 一 条 消息 ， 它 会 很 快 就 落后 于 发 布 者 。 解 决 方法 呢 ? 
打开 另外 一 个 窗口 并 运行 第 二 个 客户 端 ， 现 在 消息 处 理 的 速度 已 经 翻 倍 了 。 但 这 样 
依然 不 够 快 ， 还 不 能 跟 上 发 布 者 生产 的 数量 。 通 过 增加 客户 端 可 以 进一步 分 散 负载 ， 
并 且 避 免 让 未 处 理 的 消息 落 在 后 面 ， 这 种 部 署 就 称 为 工作 队列 。 


工作 队列 的 工作 原理 是 发 布 的 消息 在 连接 到 队列 的 客户 端 间 循环 触发 。supscribe 
命令 的 {fack:true} 参数 是 通知 AMQP 等 待 用 户 确 认 ， 看 该 消息 是 否 已 经 处 理 完 
成 。 此 反馈 确认 由 shift 方法 提供 ， 该 方法 在 应 答 过 后 把 消息 从 队列 中 移 除 ， 同 
时 将 其 从 服务 里 拿 掉 。 这 样 ， 如 果 一 个 工作 进程 在 处 理 某 个 消息 的 过 程 中 死 掉 了 ， 
RabbitMQ 代理 会 把 消息 发 给 下 一 个 可 用 的 客户 端 。 这 里 不 需要 使 用 超时 ， 只 要 客 
户 端 是 连接 上 的 ， 消 息 就 会 从 工作 流 中 移 除 。 只 有 当 客 户 端 没有 发 送 反 馈 就 断 开 了 ， 
该 消息 才 会 被 发 送 到 下 一 个 客户 端 。 


























一 个 常见 的 “疑难 杂 症 ”是 开发 者 常常 忘记 调用 q.shift () 命令 。 如 果 你 
ES》 忘记 这 个 操作 ， 程 序 依然 会 正常 运行 。 但 当 某 个 客户 端 断 开 的 时 候 ， 服 务 
器 会 把 该 客户 端 处 理 过 的 所 有 消息 都 重新 放 到 队列 中 。 

另 一 个 副作用 是 ，RabbitMQ 使 用 的 内 存 会 不 停 地 上 升 。 这 是 因为 ， 即 使 消 
息 已 经 从 队列 的 活跃 状态 中 移 除 ， 它 们 依然 会 保存 在 内 存 里 ， 直 到 等 来 客 
户 端 的 反馈 结果 并 被 客户 端 移 除 。 
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第 7 章 


重要 的 外 部 模块 








虽然 Node 提供 的 核心 API 很 强大 ， 但 其 中 很 多 功能 还 是 过 于 底层 。 正 如 许多 基于 
Ruby 的 网 站 会 使 用 Rails 和 Sinatra 开发 ， 而 不 是 使 用 自己 编写 的 Ruby 代码 一 样 ， 
Node 社区 构建 了 许多 高 级 的 功能 库 ， 大 大 地 方便 了 开发 。 虽 然 这 些 模块 从 技术 上 讲 
并 不 是 Node 本 身 ， 但 它们 对 完成 工作 非常 重要 ， 而 且 其 中 许多 库 自身 就 是 成 熟 的 
项 目 。 本 章 将 介绍 Node 社区 提供 的 儿 个 最 流行 及 最 有 用 的 模块 。 





7.1 Express 


Express (Node 的 MVC 框架 ) 也 许 是 使 用 最 广泛 的 Node 模块 了 ， 它 吸取 了 Ruby 
的 Sinatra 框架 的 精髓 ， 并 提供 了 许多 功能 ， 使 得 用 Node 构建 网 站 变 得 非常 简单 。 


7.1.1 一 个 简单 的 Express 应 用 

Express 通过 路 由 定义 的 页 面 处 理 器 来 工作 。 路 由 可 以 是 一 个 简单 的 路 径 ， 也 可 以 比 
较 复 杂 。 处 理 器 可 以 简单 地 输出 Hello, world， 也 可 以 复杂 得 像 一 个 与 数据 库 交 互 的 
完整 页 面 演 染 系统 。 需 要 先 运行 npm install express 来 安装 Express， 然 后 才 
能 开始 使 用 它 。 例 7-1 演示 了 如 何 用 Express 创建 一 个 简单 的 应 用 。 

例 7-1 创建 一 个 简单 的 Express 应 用 


Var express = require('express'); 








Var app = express.createServer(); 
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app.get ('/', function(req, res) { 
res.send('hello world'); 


ps: 


app.listen(9001); 


从 创建 服务 器 的 角度 来 看 ， 这 段 代码 与 http 模块 非常 相似 ， 但 有 几 点 更 加 直 
观 。 首 先 ，app.get () 为 特定 的 路 由 (例子 中 为 '/') 创建 了 响应 函数 。 与 一 般 
的 http 服务 器 不 同 的 是 ，Express 不 是 为 一 般 的 请 求 提供 监听 器 ， 而 是 针对 特定 
的 HTTP 动作 提供 监听 器 。 所 以 get () 只 会 响应 GET 请 求 ，put () 只 处 理 PUT 请 
求 ， 等 等 。 配 合 上 我 们 指定 的 路 由 ， 你 马上 可 以 拥有 更 为 强大 的 功能 。 一 个 典型 的 
Express 程序 会 指定 一 系列 表达 式 ，Express 会 为 每 个 进入 的 请 求 对 所 有 的 表达 式 按 
序 进行 路 由 匹配 ， 然 后 执行 第 一 个 匹配 的 表达 式 对 应 的 代码 。 

|。 我们 还 可 以 利用 next () 函数 ， 让 Express 在 特定 的 情况 下 跳 过 表达 式 ， 这 
MA 4 会 在 本 章 后 面 进行 讨论 。 








接 下 来 看 看 我 们 是 如 何 响应 请 求 的 。 我 们 依然 使 用 同 http 中 一 样 的 response 对 
象 ， 但 Express 增加 了 send() 方法 。 因 此 ， 我 们 不 需要 手动 提供 HTTP 头 或 者 是 
调用 enda() 方法 ，send() 方法 会 处 理 好 如 何 发 送 HTTP 头等 操作 ， 并 会 自动 包含 
end() 调用 。 


这 里 需要 了 解 的 是 ，Express 是 把 http 的 基础 功能 封装 起 来 ， 并 通过 提供 众多 的 功 


能 来 丰富 它 ， 使 得 创建 真正 的 应 用 非常 便捷 。 你 不 需要 在 每 次 处 理 HITP 请 求 的 时 
候 自 己 编写 代码 来 处 理 路 由 逻辑 ，Express 都 为 你 处 理 好 了 。 





7.1.2 在 Express 中 设置 路 由 


路 由 是 Express 的 一 个 核心 概念 ， 也 是 Express 非常 有 用 的 原因 之 一 。 正 如 上 一 小 节 
中 介绍 的 那样 ， 路 由 通过 实现 同名 的 方法 〈 如 get () 、post () ) 来 支持 一 个 HTTP 
动作 。 路 由 包含 了 一 个 简单 的 字符 串 或 者 一 个 正则 表达 式 ， 并 且 可 以 包含 变量 声明 、 
通配符 及 可 选 关 键 字 标记 。 让 我 们 看 几 个 例子 ， 先 从 例 7-2 开始 。 


例 7-2 ”通过 变量 和 可 选 标 记 选 择 路 由 


Var express = require('express'); 
Var app = express.createServer(); 


app.get ('/:id?', function(req, res) { 
if(req.params.id) { 
res.send (req.params .id); 
} else { 
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res.send('oh hai') 
} 
] ) ; 


app.listen(9001); 


本 例 演示 了 如 何在 一 个 路 由 中 包含 一 个 可 选 的 变量 ia。Express 并 不 关心 变量 的 取 
名 ,但 之 后 能 够 在 回调 函数 中 使 用 它 。 在 Express 路 由 中 ， 我 们 使 用 冒号 (:) 来 
标记 想 要 使 用 的 变量 ， 那 么 在 URL 中 传递 的 字符 串 就 会 被 捕获 并 保存 在 该 变量 
中 。Express 中 的 所 有 路 由 最 终 都 会 转变 成 正则 表达 式 来 处 理 ( 稍 后 会 做 更 多 介 
绍 )， 并 进行 分 词 ' 操作 以 便于 应 用 代码 的 使 用 。? 正则 表达 式 用 来 匹配 路 由 中 下 一 
个 已 知 的 词 。 注 意 ， 这 个 变量 其 实 是 可 选 的 。 如 果 你 运行 此 程序 ， 然 后 访问 http:// 
localhost:9001， 就 只 会 得 到 “oh hai” 的 响应 ， 因 为 你 没有 在 端口 后 面 用 / 带 上 路 
由 的 可 选 变量 部 分 。 如 果 随 意 带 上 点 什么 内 容 〈 只 要 不 包含 另外 一 个 /在 里 面 )， 
就 将 在 响应 内 容 中 得 到 一 样 的 内 容 ， 因 为 匹配 了 ia 关键 字 的 内 容 会 被 保存 在 req. 
params .id 中 。 

















Express 路 由 总 是 将 / 视 作 一 个 标记 ， 而 同时 又 会 把 请 求 末 尾 的 / 当做 可 选项 ， 所 
以 我 们 提供 的 路 由 / :iq? 会 匹配 上 localhost、localhost/、localhost/tom 和 
localhost/tom/， 但 不 包括 localhost/tom/tom。 


路 由 中 也 可 以 使 用 通配符 ， 如 例 7-3 所 示 ，(*) 会 匹配 所 有 的 内 容 ， 直 到 下 一 个 标 
记 出 现 ( 非 贪心 的 正则 匹配 )。 


例 7-3 在 路 由 中 使 用 通配符 


app.get ('/a*', function(req,res) { 
res.send('a'); 
// 匹配 /afoo /a.bar /a/qux 等 
Fy 


app.get ('/b*/c*d', function(reqg,res) { 
res.send('b'); 
// 匹配 /b/cd /b/cfood /b//c/d/ 等 
// 不 匹配 /b/c/d/foo 

J 


app.get ('*', function(req, res) { 
res.send('*')，; 
// 匹 配 /a /c /b/cda /b/c/d /b/c/d/foo 
// 不 匹配 /afoo /bfoo/cbard 

} 








注 1: 分 词 (tokenize) 指 的 是 把 一 个 文本 字符 串 按 块 或 按 词 切 分 成 一 个 个 标记 的 过 程 。 
注 2: 这 个 功能 实际 上 是 Express 的 一 个 子 模块 router 完成 的 。 你 可 以 参考 router 模块 的 源 代码 来 了 解 
更 多 关于 路 由 正则 表达 式 的 细 市 。 
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当 使 用 通配符 来 构建 路 由 时 ， 两 个 通配符 之 间 的 标记 必须 匹配 ， 除 非 它 是 可 选 的 。 
通配符 通常 用 在 包含 (.) 的 文件 名 中 。 还 需要 注意 的 是 ， 与 许多 其 他 正则 表达 式 语 
言 不 同 ，* 表示 的 不 是 零 个 以 上 字符 ， 它 表示 的 是 一 个 以 上 字符 。 一 个 斜 杠 〈/) 在 
匹配 通配符 的 时 候 可 以 认为 是 一 个 字符 。 


另外 需要 注意 的 是 ， 路 由 是 按 顺 序 执行 的 。 当 多 个 路 由 同时 匹配 上 提供 的 URL 时 ， 
只 有 第 一 个 匹配 的 路 由 会 执行 相关 的 动作 ， 也 就 是 说 ， 如 何 安排 路 由 的 顺序 是 很 重 
要 的 。 在 前 面 的 例子 里 ， 即 便 通 配 符 能 够 匹配 所 有 的 URL， 它 也 只 能 捕获 前 面 的 路 
由 未 能 匹配 的 URL。 


你 还 可 以 用 正则 表达 式 来 定义 路 由 ( 例 7-4)。 如 果 使 用 了 这 个 方法 ， 路 由 不 会 对 正 
则 匹配 的 内 容 做 进一步 处 理 。 所 以 当 你 想 从 URL 中 提取 变量 时 ， 需 要 用 正则 的 语法 
进行 处 理 。 

例 7-4 用 正则 表达 式 来 定义 路 由 


Var express = require('express'); 
Var app = express.createServer(); 





















































app.get (/\/(\d+)/, function(req, res) { 
res.send(req.params [0] ); 


门 子 


app.listen(9001); 


在 这 个 例子 里 ， 正 则 表达 式 只 会 匹配 以 数字 开头 的 URL (\a 表示 匹配 任意 的 数字 ， 
十 允许 匹配 1 个 或 多 个 )。 这 表示 / 不 会 被 匹配 ， 而 /12 则 会 被 匹配 。 其 实 ， 正 则 
匹配 调用 的 是 RegExp .match () 方法 ， 它 会 在 一 个 较 长 的 字符 串 中 寻找 匹配 的 部 分 
内 容 ， 所 以 /12abc 也 会 被 匹配 。 如 果 你 想 确 保 正 则 表达 式 匹配 完整 的 路 由 ， 就 需 
要 在 表达 式 的 末尾 添加 $ 标 记 ， 如 八 /(\dar)S$/。 因 为 $ 会 检查 是 否 为 行 尾 ， 所 以 
这 个 表达 式 只 有 结束 了 才 会 被 匹配 。 


也 许 你 想 让 Express 的 默认 行为 忽略 URL 结尾 的 /， 那 么 只 要 在 所 有 的 字符 串 末 尾 
用 \/?$ 替换 $ 就 可 以 了 。 


注意 看 我 们 在 例 7-4 中 是 如 何 访问 正则 表达 式 中 提取 的 变量 的 。 当 你 在 路 由 中 使 用 
正则 表达 式 时 ， 可 以 通过 reg .params 数组 来 访问 提取 的 变量 。 当 router 模块 把 
你 提供 的 路 由 处 理 成 正则 表达 式 时 ， 这 也 同样 有 效 ， 只 不 过 你 可 能 更 希望 通过 变量 
名 来 访问 罢了 〈 如 之 前 的 例子 所 示 )。 你 也 可 以 在 路 由 的 正则 匹配 时 指定 变量 的 命 
名 ， 如 例子 7-5 所 示 。 
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例 7-5 用 正则 表达 式 的 同时 指定 变量 类 型 
Var express = require('express'); 


Var app = express.createServer(); 


app.get ('/:id(\\d+)', function(req, res) { 
res.send (req.params [0] ) ; 


a 

app.listen(9001); 
在 这 个 例子 中 ， 通 过 设置 路 由 只 匹配 数字 (正则 表达 式 \a+) 来 限定 参数 id 只 能 是 
数字 。 提 取 的 变量 依然 可 以 通过 red.params .id 得到， 但 前 提 是 能 够 被 该 正则 匹 
配 。 因 为 正则 表达 式 非常 灵活 ， 所 以 你 可 以 用 此 技术 来 捕捉 或 限制 URL 该 匹配 的 
情况 ， 并 能 够 方便 地 使 用 命名 变量 。 注 意 ， 当 你 在 JavaScript 字符 串 里 输入 反 和 斜 杠 
(\) 时 ,需要 对 它 进行 转 义 。( 但 例 7-4 中 的 情况 不 需要 进行 转 义 操作 ， 因 为 那 是 直 
接 在 正则 表达 式 中 使 用 ， 而 不 是 在 字符 串 中 。) 
有 时 候 ， 你 会 希望 同一 个 URL 在 不 同 的 情景 下 匹配 上 多 个 路 由 。 我 们 已 经 看 到 了 
路 由 定义 的 顺序 会 决定 哪个 路 由 被 选中 使 用 。 但 是 ， 当 某 些 条 件 不 满足 的 时 候 〈 例 
7-6) ， 依 然 有 办 法 可 以 把 控制 权 传 给 下 一 个 路 由 ， 这 在 许多 情况 下 会 很 有 用 。 
例 7-6 把 控制 权 传 给 下 一 个 路 由 


app.get('/users/:id', function(req, res, next){ 
var id = req.params.id; 









































if (checkPermission(id)) { 
// 显示 个 人 页 而 
} else { 
next () ; 
} 
} ) ; 

















app.get('/users/:id', function(req, res){ 
// 显示 公共 页 还 

















}) 
我 们 对 路 由 的 处 理 函 数 增加 了 一 个 新 的 参数 ，next 参数 会 通知 路 由 中 间 件 去 调用 下 
一 个 路 由 ( 稍 后 我 们 会 详细 介绍 中 间 件 )。 这 个 参数 总 是 会 传递 给 回调 函数 的 ， 只 不 
过 我 们 在 这 个 例子 里 是 第 一 次 为 它 命名 并 使 用 它 。 在 这 个 例子 里 ,我 们 通过 检查 ia 
来 查看 用 户 是 否 有 权限 查看 该 页 面 的 私有 版 本 。 如 果 没 有 权限 ， 就 把 他 带 到 下 一 个 
显示 公共 版 本 的 路 由 去 。 
这 还 能 与 app.all() 方法 很 好 地 配合 ， 它 表示 所 有 的 HTTP 动作 都 进行 处 理 。 如 
例 7-7 演示 的 内 容 ， 我 们 可 以 同时 捕捉 各 种 HTTP 动作 及 路 由 ， 添 加 一 些 处 理 逻 辑 ， 
然后 把 控制 权 交 给 更 加 具体 的 路 由 。 
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例 7-7 使 用 app.all() 来 处 理 不 同 的 HTTP 动作 和 路 由 ， 然 后 交 回 控制 权 
var express = require('express'); 
var app = express.createServer(); 
var users = [{ name: 'tj' }, { name: tom }]; 


app.all('/user/:id/:op?', function(req, res, next){ 
req.user = users [req.params.id]; 


if (req.user) { 
next () ; 
} else { 
next (new Error('Cannot find user with ID: ' + req.params.id)); 
} 
站 


app.get ('/user/:id', function(req, res){ 
res.send('Viewing ' + req.user.name); 


})s 


app.get ('/user/:id/edit', function(req, res){ 
res.send('Editing ' + req.user.name); 


}) ; 


app.put('/user/:id', function(req, res){ 
res.send('Updating ' + req.user.name); 


}e 

app.get ('*', function(req, res){ 
res.send('Danger, Will Robinson!', 404); 

}3 


app.listen(3000); 


这 个 例子 与 例 7-6 相似 ,我们 在 传递 控制 权 之 前 先 检 查 该 用户 是 否 存 在 。 但 是 ， 我 
们 不 但 对 后 续 的 路 径 进 行 此 操作 ， 同 时 还 对 所 有 的 HTTP 操作 都 进行 了 检查 。 通 常 
只 会 有 一 个 路 由 被 匹配 上 ， 因 此 这 样 的 写法 没有 什么 区 别 。 但 重要 的 一 点 是 ， 要 注 
意 如 何在 路 由 间 直 接 传递 数据 。 


因为 中 间 件 拥有 request 对 象 ， 所 以 当 app .al1l11() 方法 中 添加 了 req.user 属性 后 ， 
后 续 所 有 的 方法 都 能 访问 到 它 。 每 当 回调 函数 被 触发 时 ， 变 量 .reg 其 实 只 是 指 问 
中 间 件 所 持 有 的 request 对 象 。 所 以 使 用 中 间 件 的 所 有 国 数 和 路 由 对 request 对 象 的 
任何 操作 都 是 可 见 的 。 


例 7-8 展示 了 在 特定 范围 内 如 何 把 一 个 文件 扩展 名 设置 为 可 选 或 者 是 必 选 。 在 第 一 
个 get () 方法 里 ，: format 参数 是 可 选 的 (正如? 所 标记 的 )， 所 以 Express 会 对 
用 户 请 求 的 ID 进行 响应 ， 而 不 会 在 乎 其 请 求 的 是 哪 种 格式 。 它 会 交 给 程序 员 来 根 























A 
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据 不 同 的 格式 (JSON、XML、 文 本 等 ) 采取 相应 的 处 理 。 


在 第 二 个 例子 中 ，:format 参数 期 望 匹配 的 类 型 是 json 或 xmL。 如 果 没 有 匹配 的 
类 型 ， 即 便 :iaqa 参 数 是 有 效 的 ， 请 求 book 的 操作 也 不 会 进行 。 这 让 我 们 在 决定 处 
理 哪 些 请 求 时 有 了 很 强 的 控制 权 ， 并 且 能 够 确保 只 有 符合 的 格式 才 会 被 处 理 并 生成 
响应 内 容 。 


例 7-8 可 选 或 必 填 的 路 由 扩张 项 


Var express = require('express'); 
Var app = express.createServer(); 


app.get('/users/:id.:format?', function(reqgq, res) { 
res.send(req.params.id + "<br/>" + req.params.format); 
// 会 响应 : 
// /users/15 
// /users/15.xml 
// /users/15.json 


和 


app.get('/books/:idq.:format((json|xml))'，function(red，tres) { 
res.send(req.params.id + "<br/>" + req.params.format); 
// 会 响应 : 
// /books/7.json 
// /books/7.xml 
// 但 不 会 处 理 : 
// /books/7 
// /books/7.txt 


Ds 


app.listen(8080); 


7.1.3 ”处理 表单 数据 

大 部 分 例子 都 演示 了 如 何 使 用 GET 动作 ， 其 实 Express 是 以 Ruby on Rails 的 风格 
来 提供 RESTful 的 架构 的 。 利 用 Web 表单 的 隐藏 项 ， 你 可 以 让 表单 进行 各 种 操作 : 
PUT (替换 数据 )、POST (创建 数据 )、DELETE (删除 数据 ) 和 GET (获取 数据 ) 。 
我 们 来 看 一 下 例 7-9。 


例 7-9 用 Express 处 理 表单 


Var express = require('express'); 
Var app = express.createServer(); 


app.use (express.1imit('1mb')); 
app.use (express.bodyParser()); 


app.use (express.methodOverride()); 


app.get ('/', function(req, res) { 
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res.send('<form method="post" action="/">' + 
'<input type="hidden" name=" method" value="put" />' + 
'Your Name: <input type="text" name="username" />' + 
'<input type="submit" />' + 
ra/forms"):; 


] ) ; 


app.put('/', function(req, res) { 
res.send('Welcome, ' + req.body.username); 


] ) ; 


app.listen(8080); 


这 个 简单 的 例子 演示 了 如 何 使 用 表单 。 首 先 ， 创 建 一 个 Express 应 用 并 配置 使 
用 podyParser() 和 methodoverride() 方 法。bodyParser() 方 法 会 解析 
从 Web 浏览 器 发 送 来 的 请 求 正 文 ， 并 把 表单 变量 转换 成 Express 使 用 的 对 象 。 
methodoverride() 方法 允许 表单 提交 隐藏 的 _method 变量 ， 并 把 GET 方法 赫 换 
掉 ， 然 后 调用 相应 的 RESTful 方法 类 型 。 


express.1limit() 方法 指示 Express 把 请 求 正 文 的 大 小 限制 在 1MB 以 内 。 这 是 
一 个 很 重要 的 安全 考虑 ， 因 为 如 果 没 有 这 个 设置 ， 外 界 就 可 以 给 应 用 发 送 一 个 超 
大 的 内 容 并 让 bodyParser () 来 处 理 ， 这 样 就 很 容易 进行 一 个 拒绝 服务 (denial-of- 
service，Dos) 攻击 。 


才 六 
， 


请 确保 在 bodayParser() 之 后 再 调用 methodoverride() 方法 ， 否 则 ， 当 
4 Express 检查 是 否 要 处 理 GET 方法 或 者 其 他 命令 时 ， 表 单 变 量 就 无 法 被 
” 处理。 





MAY 








7.1.4 模板 引擎 

显然 ， 直 接 在 应 用 代码 里 继续 手写 HTML 代码 并 不 明智 。 对 初学 者 来 说 ， 它 既 不 可 
读 也 不 可 维护 ， 但 更 为 重要 的 原因 是 ， 把 代码 逻辑 与 表现 层 标记 混合 在 一 起 是 一 个 
糟糕 的 做 法 。 模 板 引 擎 允许 程序 员 把 精力 集中 在 如 何 把 信息 呈现 给 用 户 上 (通常 以 
不 同 的 格式 ， 如 显示 器 或 手机 格式 )， 并 把 般 入 专用 数据 的 过 程 从 处 理 流程 中 分 离 
开 来 。 

Express 是 最 小 化 的 集合 ， 因 此 并 没有 内 置 模板 引擎 ， 而 是 由 社区 开发 的 模块 来 觉 
和 争 。 一 些 流 行 的 引擎 有 Haml、Jade、Embedded Javascript (EJ)、CoffeeKup (基于 
CoffeeScript 的 引擎 ) 和 jQuery 模板 。 








例 7-10 中 ， 应 用 的 功能 是 泻 染 一 个 简单 的 Jade 模板 。 





A 
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例 7-10 ”Express 中 使 用 简单 的 Jade 模板 


Var express = require('express'); 
Var app = express.createServer(); 


app.get('/', function(req, res) { 
res.render('index.jade', { pageTitle: 'Jade Example', layout: false }); 


学 


app.listen(8080); 
运行 此 例子 ， 需 要 先 安装 Jade 模板 引擎 ; 
npm install jade 


首先 注意 的 是 ， 代 码 里 并 不 需要 引用 Jade 库 ，Express 会 解析 视图 使 用 的 模板 文件 
名 ， 并 根据 扩展 名 来 确定 该 用 哪个 模板 引擎 (本 例子 中 是 index.jade 的 jade)。 
此 ， 我 们 可 以 在 一 个 项 目 中 混合 使 用 多 种 模板 引擎 。 比 如 ， 项 目 并 不 会 限制 你 只 使 
用 Jade 或 只 使 用 CoffeeKup， 而 是 可 以 同时 使 用 两 个 。 


这 个 例子 传 了 两 个 参数 给 render 函数 ， 第 一 个 是 用 来 显示 视图 的 名 字 ， 第 二 个 包含 
了 配置 项 以 及 泻 染 需要 的 变量 。 我 们 稍 后 再 回 过 头 来 讨论 文件 名 参数 。 在 本 例 里 ， 
我 们 传 给 视图 两 个 变量 : pageTitle 和 layout。layout 变量 在 这 个 例子 中 比较 特 
别 ， 因 为 它 被 设置 为 false， 意 思 是 让 Jade 模板 引擎 在 泻 染 index.jade 的 时 候 ， 不 
要 采用 layout 模板 文件 (这 一 点 后 面 会 详细 讲 )。 


pageTitle 是 一 个 本 地 变量 ， 并 会 被 视图 内 容 所 使 用 。 它 代表 了 模板 的 使 用 原理 : 
在 index.jade 文件 中 指定 的 HTML 内 容 中 ， 有 一 个 叫做 pageTitle 的 占 位 符 ，Jade 
会 把 我 们 传递 的 值 替换 上 去 。 


第 一 个 参数 index.jade 文件 需要 放 在 views 文件 夹 下 (/views/index.jade) ， 如 例 7-11 
所 示 。 


例 7-11 Express 使 用 的 简单 Jade 文件 


人 
html (lang="en") 
head 
title =pageTitle 
body 
hi Hello, World 
p This is an example of Jade. 


在 Jade 把 我 们 提供 的 pageTitle 值 填 入 页 面 后 ， 演 染 得 到 的 效果 如 下 : 




















<!IDOCTYPE html> 
<html lang="en"> 
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<head> 
<title>Jade Example</title> 
</head> 


<body> 
<hl>Hello, World</hil> 
<p>This is an example of Jade.</p> 
</body> 
</html> 
Jade 模板 引擎 通过 把 使 用 标记 降低 到 最 少 ， 使 得 页 面 尽 量 简洁 。 你 也 许 已 经 熟悉 
HTML 里 的 各 种 标签 的 结束 记号 了 ，Jade 取代 它们 的 方法 是 根据 缩 近来 确定 页 面 的 


结构 ， 所 以 得 到 的 文件 非常 干净 且 容 易 阅 读 。 


第 1 行 !!! 5 表示 内 容 类 型 为 HTML5， 它 会 在 输出 结构 中 声明 HTML5 的 
doctype。Jade 支持 的 默认 文件 类 型 有 5、xml、default (XHTML 1.0 Transitional)、 
transitional (默认 类 型 )、strict、frameset、1.1、basic 和 mobile。 同 时 ， 
你 也 可 以 指定 自己 的 格式 ， 比 如 aoctype html PUBLIC "-//W3C//DATA XHTML 
Custom 1.10a//DE"。 





我 们 来 看 一 下 Jade 输入 的 第 4 行 的 title 标记 ，Jade 会 把 字符 串 =pageTitle 解 
析 为 “把 变量 pageTitle 的 内 容 插 入 到 此 处 ”。 在 输出 结果 中 ， 内 容 变 成 了 Jade 
Example， 这 正 是 前 文 代码 提供 的 值 。 


我 们 已 经 介绍 过 ， 还 有 许多 其 他 的 模板 选择 ， 这 些 模 板 的 功能 也 和 Jade 相差 无 几 ， 
0 
布局 与 子 视图 


布局 能 让 你 的 网 站 实现 视图 中 常用 元 素 的 共享 ， 把 内 容 与 数据 进一步 分 离开 。 通 过 
把 布局 中 的 部 件 标 准 化 ， 如 导航 、 页 由 和 页 脚 ， 你 可 以 把 开发 精力 集中 在 网 页 视图 
的 实际 内 容 上 。 


例 7-12 把 刚才 讨论 的 视图 引擎 例子 放 在 一 个 “真实 ”的 网 站 上 了 。 
例 7-12 定义 Express 中 的 全 局 模板 引擎 


Var express = require('express'); 
var app = express.createServer(); 











app.set('view engine', 'jade'); 


app.get ('/', function(req, res) { 
res.render('battlestar') 





这 个 例子 中 新 增加 了 set 命令 的 view engine 参数 ， 现 在 Express 把 Jade 引擎 作为 
默认 的 模板 引擎 了 ， 但 依然 允许 在 render 调用 的 时 候 修 改 掉 。 


render 函数 与 之 前 的 大 不 一 样 ， 因 为 已 经 设置 了 Jade 作为 默认 模板 引擎 ， 例 子 中 无 
需 指 定 文件 全 名 ，battlestar 实际 代表 了 /views/battlestar.jade。 如 例 7-13 所 示 ， 
Express 会 使 用 放 在 views/layout.jade 中 的 文件 作为 布局 ， 因 此 不 需要 再 像 例 7-10 
中 那样 把 layout 设置 为 false。 











例 7-13 ”Express 中 的 1ayout 文件 
html 
body 

hli Battlestar Galactica Fan Page 

1= body 
layout 文件 与 之 前 创建 的 视图 文件 很 像 ， 但 是 在 这 个 例子 中 有 一 个 特殊 的 pody 变量 。 
现在 解释 一 下 != body 这 行 的 意思 ， 注 意 不 要 和 文件 顶部 的 body 关键 词 混 淆 。 第 二 
个 body 并 不 是 从 应 用 代码 传递 过 来 的 一 个 变量 名 ， 那 么 它 是 从 哪里 来 的 呢 ? 
当 layout 选项 在 Express 中 设置 为 true 时 (默认 )，render 方法 会 把 第 一 个 参数 


的 内 容 解 析出 来 ， 然 后 把 演 染 好 的 输出 以 变量 body 传递 给 layout，battlestart.jade 
文件 如 例 7-14 所 示 。 





例 7-14 Express 中 的 Jade 子 视图 
p Welcome to the fan page. 


这 里 之 所 以 称 为 子 视图 ， 是 因为 它 并 没有 包含 需要 生成 页 面 的 所 有 内 容 ， 它 需要 结 
合 layout 才能 变 成 有 用 的 输出 结果 。 最 终 在 Web 浏览 器 的 输出 如 下 : 








<html> 
<body> 
<hl>Battlestar Galactica Fan Page</hi1> 
<p>Welcome to the fan page.</p> 
</body> 
</html> 


子 视图 很 有 用 ， 因 为 它 使 得 开发 者 可 以 把 注意 力 集中 在 需要 显示 的 特定 内 容 上 ， 而 
不 需要 关注 整个 网 页 。 这 意味 着 内 容 不 需要 绑 定 在 某 个 网 页 上 ， 而 且 也 可 以 作为 手 
机 页 面 的 输出 、AJAX 调用 的 结果 (页面 内 刷新 ) ， 等 等 。 











注意 不 要 混淆 了 变量 boay 与 关键 字 boay， 变 量 boay 包含 了 你 的 视图 的 
CB》 实际 内 容 ， 而 关键 字 boay 是 Web 浏览 器 使 用 的 一 个 HTML 标签 ， 
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7.1.5 中 间 件 

在 这 之 前 的 例子 中 ， 有 些 地 方 包含 了 看 起 来 无 关 的 函数 app.use () 。 这 个 函数 调用 了 
Connect 库 ， 并 提供 了 许多 有 用 的 工具 ， 使 得 添加 功能 很 容易 。 现 在 是 时 候 进 一 步 介 
绍 这 个 神奇 的 黏合 剂 〈 中 间 件 ) ， 以 及 它 为 什么 对 开发 Express 程序 如 此 重要 了 。 


“中 间 件 ”(middleware) 这 个 名 称 可 能 听 起 来 有 点 像 那些 爱 显摆 的 程序 员 喜 欢 使 用 
的 难 懂 术 语 ， 但 正如 前 面 章 节 中 提 到 的 ， 中 间 件 指 的 是 链接 两 个 程序 的 一 个 软件 ， 
并 且 通 常 是 更 高 级 的 程序 间或 者 更 宽广 的 网 络 间 的 软件 。 在 实际 工作 中 ， 中 间 件 好 
比 你 家 里 或 办 公 室 里 看 得 见 的 电话 线 ， 所 有 电话 (应 用 ) 都 连接 到 电话 线 (中 间 件 ) 
上 ， 而 后 者 能 把 应 用 与 对 应 底层 的 网 络 链接 起 来 。 


你 的 电话 也 许 支持 呼叫 等 待 或 语音 信箱 ， 但 不 管 什么 功能 ， 线 路 工作 方式 都 一 样 。 
你 可 以 把 语音 信箱 内 置 在 电话 中 ， 或 者 是 通过 电信 公司 (网络) 提供 ， 但 无 论 哪 种 
情况 ， 线 路 本 身 都 乐于 为 你 服务 。 


Connect 库 提供 了 Express 使 用 的 中 间 件 功能 〈 见 表 7-1)。 如 图 7-1 所 示 ，Connect 扩 
展 了 Node 的 基础 http 模块 ， 为 它 赋 予 了 http 能 提供 的 所 有 基础 服务 ， 然 后 在 此 
基础 上 又 增加 了 自己 的 功能 。Express 是 从 Connect 继承 下 来 的 ， 同 时 获得 了 http 和 
connect 的 功能 。 任 何 添加 到 Connect 的 模块 都 会 自动 被 Express 所 使 用 。Connect 
是 链接 Express 和 网 络 的 中 间 层 ， 它 提供 及 使 用 了 众多 的 功能 ， 这 些 功能 也 许 不 能 
被 Express 直接 使 用 ， 但 可 用 性 都 是 一 样 的 。 最 后 ， 因 为 Express 本 身 从 Connect 而 
来 ， 所 以 Connect 的 大 部 分 功能 都 能 直接 从 Express 中 使 用 ， 这 使 得 你 可 以 使 用 app . 
bodyParser () 这 类 命令 ， 而 不 需要 调用 connect .bodyParser () 之 类 。 


















































图 7-1: Express 的 中 间 件 栈 
表 7-1: 与 Connect 绑 定 的 中 间 件 














名 称 描 述 
basicAuth 回调 函数 接受 username 和 password 参数 ， 如 果 该 证 书 允 许 访 问 网 站 ， 则 函数 
返回 值 为 真 
bodyParser 解析 请 求 正文 的 内 容 
compiler 把 .sass 和 .less 文件 编译 成 CSS， 把 CoffeeScript 文件 编译 成 JavaScript 
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( 续 ) 























名 称 描 述 

.CookieParser 解析 从 浏览 器 发 送 过 来 的 请 求 包头 中 cookie 的 内 容 

csrf 通过 改变 额外 的 表单 变量 提供 伪造 跨 域 请 求 (CSRF)， 依 赖 session 和 
bodyParser 中 间 件 

directory 打印 根 路 径 下 的 文件 夹 ， 可 以 选择 是 否 显示 隐藏 文件 和 图 标 

errorHandler 捕获 应 用 遇 到 的 错误 ， 提 供 选 择 把 错误 记录 到 stderr 或 者 是 其 他 格式 (JSON、 纯 
文本 或 HTML) 

favicon 通过 缓存 控制 ， 从 内 存 提 供 favicon 文件 服务 

limit 限制 服务 器 能 接受 的 请 求 的 大 小 ， 避 免 DoS 攻击 

logger 在 响应 时 (默认 ) 或 接收 请 求 时 ， 把 请 求 内 容 记录 到 标准 输出 或 文件 ， 并 且 允 许 




















使 用 多 种 格式 。 通 过 改变 缓存 大 小 来 控制 写 到 磁盘 的 频率 

methodoverride 结合 bodyParser 提供 DELETE、PUT 以 及 POST 方法 。 人 允许 更 为 明确 的 路 由 定 
义 ， 比 如 ， 使 用 app .put () 来 替代 在 app .post () 中 检查 用 户 的 意图 。 这 个 技 
术 能 够 帮助 设计 RESTful 应 用 。 




































































profiler 一 般 是 放 在 其 他 所 有 中 间 件 的 前 面 ， 它 会 记录 请 求 对 应 的 响应 时 间 和 内 存 使 用 情况 
query 解析 query 字符 串 ， 然 后 保存 到 reg . query 参数 中 
responseTime 生成 响应 内 容 时 ， 把 时 间 (单位 是 毫秒 ) 填 入 X-Response-Time 头 
router 提供 高 级 路 由 功能 ( 详 见 7.1.2 节 ) 
session 让 多 个 请 求 共享 用 户 数 据 的 session 管理 
static 允许 从 根 目录 提供 静态 文件 服务 。 支 持 部 分 下 载 和 自 定 义 过 期 时 限 
staticCache 为 static 中 间 件 增加 缓存 层 ， 通 过 把 热门 文件 放 在 内 存 而 提高 响应 速度 
vhost 允许 在 单一 机 器 上 以 不 同 的 vhost 提供 站 点 服务 
中 间 件 工厂 


到 目前 为 止 ， 你 也 许 注意 到 了 中 间 件 包含 的 功能 比 起 Express 顺序 执行 的 函数 要 多 
一 些 。JavaScript 的 闭 包 让 我 们 能 够 在 Node 内 部 实现 工厂 模式 ， 并 且 能 为 你 的 网 
站 路 由 提供 上 下 文 处 理 功能 。 


Express 的 路 由 功能 会 在 处 理 环节 使 用 内 部 的 中 间 件 ， 可 以 通过 重 载 来 添加 额外 的 功 
能 ， 比 如 ， 在 HTML 输出 中 添加 自 定义 头 。 我 们 来 看 一 下 例 7-15， 看 看 如 何 利用 中 
间 件 工厂 来 拦截 一 个 页 面 请 求 ， 并 且 强 制 进行 角色 授权 验证 。 

例 7-15 ”Express 中 的 中 间 件 工厂 


Var express = require('express'); 





Var app = express.createServer!( 
express.cookieparser(), 
express.session({ secret: 'secret key' }) 











注 3: 工厂 是 一 个 对 象 ， 它 根据 指定 的 参数 创建 出 其 他 对 象 来 。 而 如 果 采 用 手工 创建 对 象 的 方式 ， 会 导致 
出 现 大 量 重复 或 复杂 的 代码 。 














重要 的 外 部 模块 | 159 


7 


var roleFactory = function(role) { 
return function(req, res, next) { 
if ( req.session.role && req.session.role.indexof (role) != -1 ) { 
next () ; 
} else { 
res.send('You are not authenticated.'); 


} 
} 
}; 


app.get ('/', roleFactory('admin'), function(req, res) { 
res.send('Welcome to Express!'); 


}ys 


app.get('/auth', function(req, res) { 
req.session.role = 'admin'; 
res.send('You have been authenticated.'); 


} ys: 


app.listen(8080); 


马上 就 可 以 测试 一 下 ， 访问 http://localhost:8080/， 你 会 收 到 消息 “You are not 
authenticated.”。 但 是 ， 如 果 看 一 下 '/' 路 由 对 应 的 内 容 ， 你 会 发 现实 际 上 页 面 的 内 
容 是 'Welcome to Express!'。 第 二 个 参数 roleFactory('admin') 会 在 页 面 显 
示 前 被 调用 ， 并 检测 到 你 的 session 中 没有 role 属性 ， 所 以 它 停止 了 页 面 执行 并 且 
输出 自己 的 消息 。 


如 果 访 问 http://localhost:8080/auth 之 后 ， 接 着 访问 http://localhost:8080/， 你 会 得 
到 消息 “Welcome to Express!”。 在 此 情景 下 ，/auth URL 往 你 的 session 的 role 属 
性 上 添加 了 'agdmin' 变量 ， 所 以 当 roleFactory 执行 时 ， 它 会 把 执行 控制 交 给 
next () ， 也 就 是 app .get ('/') 国 数 。 


因此 ， 我 们 可 以 说 ， 通 过 内 部 的 中 间 件 ， 我 们 把 执行 顺序 改 为 : 




















(1) roleFactory ('admin') 


(2) app.get ('/') 
如 果 想 在 检查 授权 时 多 增加 一 些 角色 呢 ? 可 以 把 路 由 改 为 : 


var powerUsers = [roleFactory('admin'),roleFactory('client')]; 
app.get ('/', powerUsers, function(req, res) { 
res.send('Welcome to Express!'); 


}) ; 


因为 传人 了 一 组 中 间 件 ， 所 以 就 把 页 面 执 行 限制 成 了 同时 是 admin 和 client 角色 的 
用 户 ， 并 把 执行 顺序 改 为 了 : 
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(1) roleFactory ('admin') 
(2) roleFactory('client') 
(3) app.get ('/') 


为 每 个 roleFactory 方法 都 要 求 对 应 的 角色 在 session 中 出 现 ， 所 以 用 户 必 须 同 
时 是 client 和 admin 才能 访问 该 页 面 。 


7.2 Socket.IO 


Socket.IO 是 一 个 小 巧 的 扩展 库 ， 功 能 很 像 Node 的 核心 库 net。 你 可 以 通过 Socket. 
IO 在 浏览 器 客户 端 与 Node 服务 器 之 间 采 用 高 效 的 底层 socket 机 制 来 回 发 送 消 息 
该 模块 的 另 一 个 优点 是 ， 可 以 在 浏览 器 与 服务 器 间 共 享 代 码 。 也 就 是 说 ,一 日 旧 你 时 
立 了 连接 ， 就 可 以 用 同样 的 JavaScript 代码 在 两 边 进行 销 息 通信 。 


Socket.IO 的 名 字源 于 它 使 用 了 浏览 器 支持 并 采用 的 HTML5 WebSocket 标准 。 幸 运 
的 是 ， 该 库 还 支持 一 系列 降级 功能 : 














。 WebSocket 

。 WebSocket over Flash 

。 XHR Polling 

。 XHR Multipart Streaming 
。 Forever Iframe 

。 JSONP Polling 


在 大 部 分 情景 下 ， 你 都 能 通过 这 些 功能 选择 与 浏览 器 保持 类 似 长 连接 的 功能 。 
Socket.IO 模块 使 用 同一 套 API， 让 连接 服务 器 和 浏览 器 的 代码 能 够 共享 连接 代码 。 


创建 Socket.IO 实例 很 简单 ， 只 要 包含 该 模块 并 创建 服务 器 对 象 就 行 。 使 用 Socket. 
IO 还 有 一 点 小 区 别 ， 就 是 它 还 需要 依赖 HTTP 服务 器 ， 见 例 7-16。 


例 7-16 创建 Socket.IO 服务 器 


var http = require('http'), 
io = require('socket.io'); 


server = http.createServer(); 


server.on('request', function(req, res){ 
// 常见 的 HTTP 服务 器 内 容 
res.writeHead(200, {'Content-Type': 'text/plain'}); 


res.end('Hello World'); 


ys 


server.listen(80); 





重要 的 外 部 模块 | 161 


var Socket = io.listen(server); 


socket .on('connection', function(client){ 
console.log('Client connected' ) : 


})s 


本 例子 中 的 HTTP 服务 器 可 以 做 任何 事情 。 在 这 个 例子 里 ， 我 们 只 是 让 它 返 回 
“Hello World.”。 其 实 ，Socket.IO 并 不 关心 HTTP 服务 器 做 什么 ， 它 只 是 把 自 带 的 
事件 监听 器 包装 在 发 送 到 服务 器 的 所 有 请 求 上 ， 该 监听 器 会 查找 从 Socket.IO 客户 
端 发 送 来 的 请 求 ， 并 对 应 处 理 。 对 于 其 他 的 请 求 ， 它 会 以 原本 的 工作 方式 传递 给 
HTTP 服务 器 。 


本 例子 调用 监听 类 的 工厂 方法 io.1listen() 创建 了 一 个 socket.io 服务 器 。 因 为 
socket 是 持久 性 连接 ， 你 不 需要 像 HTTP 服务 器 那样 处 理 regq 和 res 对 象 。 与 使 用 
net 类 似 ， 你 需要 使 用 传人 的 client 对 象 来 与 每 个 浏览 器 进行 通信 。 当 然 ， 在 浏 
览 器 里 也 需要 放置 一 些 代 码 ( 例 7-17) 来 与 服务 器 交互 ， 这 同样 重要 。 


例 7-17 与 Socket.IO 服务 器 交互 的 小 网 页 


<!DOCTYPE html> 
<html> 
<body> 
<script src="/socket.io/socket.io.js"></script> 
<script> 
Var socket = io.connect('http://localhost:8080'); 
socket.on('message', function(data){ console.log(data) }) 
</SCriptS 
</body> 
</html> 





这 个 简单 的 页 面 做 的 事情 是 从 Node 服务 器 (localhost 的 8080 端口 ) 直接 加 载 需 要 
的 Socket.IO 客户 端 库 。 





虽然 80 端口 是 HTTP 的 标准 端口 ， 但 8080 端口 在 开发 的 时 候 更 为 方便 ， 

心 因为 许多 开发 者 是 在 本 地 机 器 上 允许 Web 服务 器 进行 测试 的 ， 这 样 会 和 

全 Node 的 功能 冲突 。 而 且 ， 许 多 Linux 系统 内 建 的 安全 规则 不 允许 非 管 理 员 
用 户 使 用 80 端口 ， 所 以 使 用 一 个 较 大 的 数字 作为 端口 更 为 方便 。 























接 下 来 ， 我 们 为 准备 连接 的 Socket.IO 服务 器 名 字 创 建 一 个 新 的 socket 对 象 。 然 后 
调用 socket .connect () 进行 连接 ， 并 为 消息 事件 添加 了 一 个 监听 器 。 每 当 服 务 器 
给 这 个 客户 端 发 送 一 条 消息 ， 客 户 端 就 会 把 它 输 出 到 浏览 器 的 终端 窗口 上 。 


现在 ， 让 我 们 修改 一 下 服务 器 的 代码 ， 让 它 把 此 页 面 发 送 给 客户 端 ， 并 测试 一 下 








A 
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( 例 7-18)。 
例 7-18 一 个 简单 的 Socket.IO 服务 器 


Var http = require('http'), 
io = require('socket.io'), 
fs = require('fs'); 


var sockFile = fs.readFileSync('socket.html'); 


server = http.createServer(); 

server.on('request', function(req, res){ 
res.writeHead(200, {'content-type': 'text/html'}); 
res.end(sockFile); 


} 
server.listen(8080); 
Var socket = io.listen(server); 


socket .on ('connection ' ， function(client){ 
console.log('Client connected'); 
client.send('Welcome client ' + client.sessionId) ; 
有 地 
本 例子 中 最 大 的 变化 是 增加 了 fs .readFileSync 国 数 ， 它 把 外 部 的 网 页 文件 带 入 
了 socket 服务 器 。 现 在 浏览 器 的 请 求 不 再 是 返回 Hello World 了 ，Node 服务 器 会 返 
回 socket.html 的 内 容 。 因 为 readFileSync 是 一 个 同步 函数 ， 所 以 它 会 堵塞 Node 
的 事件 循环 ， 直 到 文件 读 取 完 毕 。 这 样 能 确保 当 服 务 器 准备 好 接受 连接 的 时 候 ， 客 
户 端 能 够 马上 得 到 文件 的 内 容 。 


现在 每 当 有 人 向 服务 器 发 起 任意 请 求 ( 除 非 是 直接 往 Socket.IO 客户 端 库 发 起 的 请 
求 )， 他 都 会 得 到 socket.html 的 一 份 拷贝 (如 例 7-17 中 的 代码 )。 连 接 的 回调 函数 
被 扩展 成 往 客户 端 发 送 一 条 欢迎 信息 ， 然 后 例 7-18 中 的 客户 端 会 在 它 的 终端 上 显 
示 如 Welcome client 17844937089830637 这 样 的 内 容 ， 其 中 的 数字 ID 是 用 
Math.random() 生成 的 一 个 整数 。 


7.2.1 命名 空间 

当 你 能 够 完全 控制 自己 的 程序 与 架构 时 ， 可 以 如 例子 中 的 方法 那样 创建 websocket。 
但 当 你 把 它们 添加 到 已 在 使 用 socket 的 程序 ， 或 是 你 正在 写 的 服务 需要 租 入 到 别人 
的 项 目 中 去 时 ， 这 很 容易 会 导致 冲突 。 例 7-19 演示 了 如 何 用 命名 空间 把 Socket.IO 
的 监听 器 有 效 地 区 分 到 频道 中 ， 从 而 避免 类 似 问 题 。 

例 7-19 修改 网 页 来 使 用 Socket.IO 的 命名 空间 


<!IDOCTYPE html> 
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<html> 


<body> 
<script src="/socket.io/socket.io.js"></script> 
<script> 
var upandrunning = io.connect ('http://localhost:8080/ 
upandrunning'); 
Var weather = io.connect ('http://localhost:8080/weather'); 
upandrunning.on('message', function(data){ 


document .write('<br /><br />Node: Up and Running Update<br />'); 
document .write (data); 


] ) ; 

weather.on('message', function (data){ 
document .write('<br /><br />Weather Update<br />'); 
document .write (data).; 


}y)ss 
</script> 
</body> 
</html> 
这 个 更 新 后 的 sockethtml 版 本 创建 了 两 个 Socket.IO 连接 ， 一 个 是 http://localhost: 
8080/upandrunning， 一 个 是 http:Wlocalhost:8080/weather。 每 个 连接 有 自己 独立 的 变量 
和 .on() 事件 监听 器 。 除 了 以 上 的 区 别 ，SocketIO 工作 的 方式 保持 不 变 。 例 7-20 更 
改 了 在 终端 记录 日 志 的 方法 ， 改 为 直接 在 Web 训 览 器 窗口 中 显示 背 息 结果 。 


例 7-20 使 用 空间 的 Socket.IO 服务 器 


var sockFile = fs.readFileSync('socket.html'); 








server = http.createServer()，; 

server.on('request', function (req, res){ 
res.writeHead(200, {'content-type': 'text/html'}); 
res.end(sockFile); 


})s 
server.listen(8080); 
var socket = io.listen(server); 


socket .of ('/upandrunning') 
n('connection', function(client){ 
console.log('Client connected to Up and Running namespace.'); 
client.send("Welcome to 'Up and Running'"); 


}y): 


socket .of ('/weather') 
n('connection', function(client){ 
console.log('Client connected to Weather namespace.'); 
client.send("Welcome to 'Weather Updates'"),; 


pe 


socket .of 国 数 把 socket 对 象 切 分 成 多 个 独立 的 命名 空间 ， 每 个 空间 有 自己 的 处 理 
规则 。 如 果 一 个 客户 端 连接 到 http://localhost:8080/weather 并 发 起 emit () 命令 ， 它 
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的 结果 只 会 在 该 命名 空间 里 被 处 理 ， 而 不 会 在 /upandrunning 命名 空间 里 处 理 。 





7.2.2 Express 中 使 用 Socket.IO 

许多 时 候 你 会 想 要 使 用 Socket.IO， 把 它 作 为 Node 中 的 独立 程序 或 者 一 个 包含 Node 
之 外 模块 的 大 型 网 站 的 一 部 分 。 如 果 是 同时 使 用 Express 和 Socket.IO， 你 将 会 在 使 
用 统一 的 语言 (JavaScript) 编写 整个 软件 的 结构 (包括 面向 客户 端的 视图 ) 方面 获 
得 巨大 便利 。 

下 面 ， 先 把 例 7-21 保存 为 socket_express.html。 


例 7-21 Socket.IO 绑 定 到 Express 应 用 上 : 客户 端 代码 


<script src="/socket.io/socket.io.js"></script> 


<SCEipt> 
Var socket = io.connect('http://localhost:8080'); 
socket.on('news', function (data) { 


document .write('<hl>' + data.title + '</hl>' ); 
document .write('<p>' + data.contents + '</p>' ); 


if ( data.allowResponse ) { 
socket.emit('scoop', { contents: 'News data received by client.' }); 
} 
] ) ; 
</script> 


本 例子 从 连接 Socket.IO 的 8080 端口 开始 。 当 Socket.IO 服务 器 发 送 news 事件 的 时 
候 ， 客 户 端 会 把 新 项 目的 标题 和 内 容 写 到 浏览 器 页 面 上 。 如 果 该 news 项 目 允 许 有 
反馈 ， 客 户 端 socket 还 会 发 起 scoop 事件 。scoop 对 于 报道 源 没 有 什么 用 处 ， 它 只 
是 表示 客户 端 反 馈 接收 了 原始 新 闻 。 


作为 一 个 新 闻 业 务 的 例子 ， 服 务 器 对 scoop 事件 的 响应 是 发 起 另 一 个 新 闻 消 息 ， 客 
户 端 会 收 到 新 的 事件 并 打印 到 屏幕 上 。 为 了 防止 这 一 循环 无 休止 进行 下 去 ， 发 送 新 
闻 消 息 的 时 候 会 同时 发 送 allowResponse 参数 。 如 果 它 是 false 或 完全 没有 出 现 
( 见 例 7-22) ， 客 户 端 则 停止 发 送 scoop。 

例 7-22 演示 了 如 何 结合 Express 服务 器 使 用 。 


例 7-22 ”Socket.IO 绑 定 到 Express 应 用 上 : 服务 器 代码 


var app 
io 





require('express') .createServer(), 
require('socket.io').listen(app); 


app.listen(8080); 


app.get('/', function(req,res) { 
res.sendfile( dirname + '/socket express.html'); 


月 到 
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io.sockets.on('connection', function(socket) { 
socket.emit('news', { 
title: 'Welcome to World News', 
contents: 'This news flash was sent from Node.js!', 
allowResponse: true 


Ds 
socket.on('scoop', function(data) { 
socket.emit('news', { 
title: 'Circular Emissions Worked', 
contents: 'Received this content: ' + data.contents 


} 
有 
先 创建 Express 服务 器 并 处 理 ， 然 后 把 它 作为 参数 传人 Socket.IJO。 当 Express 应 用 
从 listen() 国 数 开始 运行 后 ，Web 服务 器 和 socket 服务 器 同时 启动 。 下 一 步 ， 定 
义 在 根 路 径 (/) 上 的 路 由 负责 把 例 7-21 创建 的 客户 端 文件 发 送出 去 。 


新 闻 中 心 的 服务 器 代码 与 客户 端 代码 看 起 来 很 像 ， 这 是 有 原因 的 。 在 Node 和 Web 
浏览 器 中 同样 的 事件 (emit、on 消息 、connection) 行为 类 似 ， 这 使 得 连接 的 获得 
更 加 直观 。 因 为 数据 是 作为 JavaScript 对 象 在 两 边 传递 的 ， 所 以 不 需要 额外 的 解析 
或 序列 化 工作 。 





可 见 ， 通 过 把 Socket.IO 加 入 Express， 我 们 可 以 立马 获得 许多 功能 ， 但 精明 的 程 
序 员 会 发 现 这 种 单 向 的 通信 方式 价值 有 限 ， 除 非 从 用 户 浏 览 器 发 起 的 连接 能 够 以 
socket 流 的 方式 使 用 。 任 何 修改 〈 登 出 、 修 改 设置 等 操作 ) 应 该 在 socket 操作 中 反 
馈 出 来 ， 反 之 亦 然 。 如 何 完成 此 功能 呢 ? 答案 是 使 用 session。 


接 下 来 演示 一 下 如 何 用 session 来 做 权限 验证 ， 先 看 一 下 客户 端 代 码 (views/socket. 
html) ， 见 例 7-23 。 

















例 7-23 客户 端 HIML (Jade 模板 ) : Socket.IO sessions 


1 
html (lang='en') 
head 
Script (type='text/javascript', src='/socket.io/socket.io.js') 
Script (type='text/javascript') 
Var socket = io.connect('http://localhost:8080'); 
socket .on('emailchanged', function (data) { 
document .getElementById('email') .value = data.email,; 


}) ; 
var submitEmail = function(form) { 
socket .emit ('emailupdate', {email: form.email.value}); 
return false; 
}; 
body 





hil Welcome! 


form(onsubmit='return submitEmail (this);') 


input (id='email', name='email', type='text', value=locals.email) 


input (type='submit', value='Change Email') 


当 浏 览 器 泻 染 时 ， 这 个 页 面 会 显示 一 个 表单 文本 框 (内 容 为 Change Email) ， 默 认 
值 是 从 Express 的 session 数据 中 的 locals .email 变量 取得 。 用 户 输入 后 ， 应 用 程 


序 进行 以 下 操作 : 


(1) 创建 一 个 Socket.IO 连接 ， 并 把 用 户 的 所 有 Email 更 改 以 emailupdate 事件 发 


(2) 监听 emailchanged 事件 ， 当 服务 器 返回 新 的 Email 地 址 时 ， 更 改 文本 框 的 内 


容 (后 续 我 们 会 讲解 更 多 这 方面 的 内 容 )。 
接 下 来 ， 我 们 看 看 例 7-24 的 Node.js 代码 部 分 。 


例 7-24 在 Express 和 Socket.IO 间 共 享 session 数据 


Var io = require('socket.io'); 

Var express = require('express'); 

Var app = express.createServer(); 

var store = new express.session.MemoryStore; 
var utils = require('connect') .utils; 


var Session = require('connect') .middleware.session.Session; 


app.configure (function() { 
app.use (express.cookieparser () ) ; 


app.use (express.session({secret: 'secretKkey', key: 


store: store})); 
app.use (function(req, res) { 
var sess = req.session; 
res.render('socket.jade', { 
email: sess.email || ! 


// 启动 应 用 
app.listen(8080); 


var sio = io.listen(app); 


sio.configure (function() { 
sio.set ('authorization', function (data, accept ) 


'express.sid', 


{ 


var cookies = utils.parseCookie(data.headers.cookie),; 


data.sessionID = cookies['express.sid']; 
data.sessionStore = store; 


store.get (data.sessionID, functionl(err, session) 


if (err || !session ) { 


{ 
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return accept ("Invalid session", false); 
data.session = new Session(data, session); 
accept (null,true); 
的 这 
二 


Sio.sockets.on('connection'，function(socket) { 
var session = socket.handshake.session; 
socket .join(socket.handshake.sessionId),; 


socket .on('emailupdate', function (data) { 
session.email = data.email; 
session.save(); 
sio.sockets.in(socket.handshake.sessionId) .emit ('emailchanged', { 


email: data.email 


}: 


这 个 例子 使 用 了 Connect 的 中 间 件 框架 来 简化 公共 操作 ， 比 如 session 管理 、cookies 
操作 、 用 户 认证 、 缓 存 、 性 能 指标 等 。 在 本 例子 中 ，cookie 和 session 工具 用 来 处 
理 用 户 数据 。Socket.IO 并 不 知道 Express 的 存在 ， 反 之 也 如 此 ， 所 以 Socket.IO 并 
不 知道 当 用 户 连接 时 的 session。 但 是 所 有 模块 都 需要 使 用 Session 对 象 来 共享 数据 ， 
这 很 好 地 演示 了 概念 分 离 (Separation of Concerns，SoC)“ 的 编程 范例 。 





这 个 例子 演示 了 在 连接 之 后 ， 通 过 解析 用 户头 信息 ， 用 户 认证 后 使 用 Socket.IO。 
为 session 的 ID 是 通过 cookie 传 给 服务 器 的 ， 所 以 你 可 以 通过 此 值 来 读 取 Express 
的 session ID。 


这 次 ，Express 设置 包含 了 一 行 session 管理 配置 。 创 建 session 管理 器 有 几 个 参数 ， 
分 别 是 secret (用 来 防止 session 破解 )、key (在 Web 浏览 器 cookie 中 用 来 保存 
session ID)、store 对 象 (用 来 保存 session 数据 ， 以 便 后 续 获 取 )， 其 中 store 对 象 
是 最 重要 的 。 这 个 例子 是 自己 创建 一 个 变量 ， 然 后 传 给 Express， 而 不 是 由 Express 
创建 和 管理 内 存 存储 。 现 在 session 存储 可 以 跨越 Express， 让 整个 应 用 都 能 访问 了 。 


下 一 步 ， 为 默认 (/) 网 页 创建 一 个 路 由 。 在 之 前 的 Socket.IO 例子 中 ， 这 个 函数 是 
用 来 直接 把 HTML 输出 到 Web 浏览 器 的 。 这 次 ，Express 会 把 views/socket.jade 的 
内 容 演 染 以 后 再 发 给 Web 浏览 器 。render() 的 第 二 个 变量 是 保存 在 session 里 的 
E-mail 地 址 ， 在 例 7-23 中 将 会 把 它 解析 并 作为 文本 框 的 默认 值 。 











注 4: SoC 指 的 是 把 软件 拆 分 成 更 小 的 独立 模块 (关注 点 )， 尽 量 使 它们 互相 之 间 没 有 重合 功能 。 中 间 件 有 
助 于 这 样 的 设计 风格 ， 因 为 它 能 允许 完全 独立 的 模块 在 一 个 公共 环境 中 交互 ， 而 且 不 需要 知道 彼此 的 
情况 。 但 是 ， 正 如 我 们 所 见 的 如 bodyParser( 这 样 的 模块 ， 它 还 是 需要 程序 员 来 了 解 模块 间 最 终 是 如 
何 交互 的 ， 并 由 程序 员 按 合适 的 顺序 和 上 下 文 情况 来 使 用 它 。 
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真正 的 动作 是 在 Socket.IO 的 'authorization' 事件 中 完成 的 。 当 Web 浏览 器 连 
接 到 服务 器 时 ，Socket.IO 进行 权限 验证 操作 ， 以 确认 该 连接 是 否 可 以 进行 后 续 操 
作 。 这 个 例子 中 的 验证 标准 是 session 是 否 有 效 ， 这 是 当 用 户 读 取 网 页 时 由 Express 
提供 的 。Socket.IO 通过 parseCookie (Connect 框架 的 功能 ) 从 请 求 头 中 读 取 
session ID ， 然 后 从 内 存 存 储 中 读 取 session， 接 着 根据 接收 的 信息 创建 session 
对 象 。 


传递 给 authorization 事件 的 数据 是 保存 在 socket 的 握手 (nandshake) 资源 中 。 因 
此 ， 在 数据 对 象 中 保存 session 对 象 使 得 它 能 够 在 socket 的 生命 周期 中 使 用 。 当 
创建 session 对象 时 ， 使 用 创建 的 内 存 存 储 并 传递 给 Express， 这 样 Express 和 
Socket.IO 都 可 以 访问 同样 的 session 数据 。Express 通过 red.session 对 象 访问 ， 
sockets 通过 socket .handshake.session 对 象 访问 。 























假设 一 切 运行 顺利 ， 调 用 accept () 对 socket 进行 授权 ， 并 允许 该 连接 继续 运行 。 


现在 可 以 支持 用 户 在 浏览 器 中 从 不 同 的 标签 页 面 同时 访问 你 的 网 站 了 。 这 样 同一 
个 session 会 创建 两 个 连接 ， 那 么 你 该 如 何 处 理 已 连接 的 socket 的 更 新 呢 ? Socket. 
IO 提供 了 房间 (room) 和 频道 (channel)， 你 可 以 根据 自己 的 喜好 使 用 它们 。 在 例 
7-24 中 ， 通 过 用 sessionIg 作为 参数 来 初始 化 join() 命令 ，socket 透明 地 创建 了 
一 个 专用 频道 ， 这 样 你 就 可 以 往 该 用 户 使 用 的 所 有 连接 中 发 送 消 息 。 登 出 是 这 一 技 
术 的 明显 应 用 。 当 用 户 从 一 个 标签 页 中 登 出 时 ,该 登 出 命令 会 立即 传送 给 其 他 所 有 
页 面 ， 让 用 户 所 看 见 的 该 应 用 页 面 的 状态 保持 一 致 。 














在 修改 session 数据 后 ， 确 保 记 得 执行 session.save() ， 否 则 该 修改 不 会 


CE》 反映 在 后 续 的 请 求 中 。 
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扩展 Node 





8.1 模块 


Node 的 模块 系统 使 其 很 容易 创建 扩展 功能 。 它 很 好 学 习 ， 并 能 让 我 们 轻松 编写 可 重 
用 的 代码 库 。Node 模块 系统 基于 commonJS 模块 标准 。 在 前 面 的 章节 中 ， 我 们 已 经 
使 用 了 许多 模块 了 ， 现 在 我 们 学 习 如 何 创 建 自己 的 模块 。 例 8-1 演示 了 一 个 简单 的 
实现 。 


例 8-1 一 个 简单 的 模块 


exports .myMethod 
exports.property 


正如 你 所 见 ， 编 写 一 个 模块 就 是 往 全 局 变量 exports 上 添加 一 些 属性 那么 简单 。 任 
何 通过 require() 包含 进来 的 脚本 都 会 返回 它 的 exports 对 象 ， 这 意味 着 所 有 从 
require() 返回 的 内 容 都 在 一 个 闭 包 里 ， 你 在 模块 内 使 用 的 私有 变量 并 不 会 暴露 给 
整个 程序 的 作用 域 。 


Node 开发 人 员 已 经 为 模块 创建 了 一 些 约定 。 首 先 ， 它 一 般 通 过 创建 工厂 方法 来 构 
建 类 。 虽 然 也 可 以 暴露 类 本 身 ， 但 工厂 方法 给 了 我 们 一 种 整洁 的 方法 来 实例 化 对 
象 。 对 于 IO 相关 的 类 ， 其 中 一 个 参数 通常 是 个 回调 函数 ， 或 者 用 来 表示 IO 操 
作 完 成 ,或 者 表示 其 中 一 些 常 见 的 环节 。 比 如 ，http.server 有 一 个 工厂 方法 叫 
http.createServer(),， 它 会 对 http.Server 中 最 常见 的 request 事件 调用 回 
调 函 数 。 








function() { console.log('Method output') }; 
"blue"; 
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8.2 包 管 理 


可 以 自己 编写 模块 固然 很 好 ， 但 最 终 还 需要 有 好 的 方法 来 发 布 它们 ， 并 与 团队 的 其 
他 成 员 或 与 社区 进行 分 享 。Node 的 包 管 理 系 统 (npm) 提供 了 发 布 代码 的 方法 ， 或 
者 将 代码 发 布 到 本 地 ， 或 者 通过 全 局 的 Node 模块 资源 库 。npm 帮助 你 管理 代码 依 
赖 包 的 安装 ， 以 及 其 他 与 发 布 代码 相关 的 工作 。 而 且 ，npm 是 完全 用 JavaScript 和 
Node 编写 的 ， 所 以 你 如 果 已 经 在 使 用 Node， 那 么 就 已 经 在 使 用 npm 了 。npm 给 开 
发 者 提供 了 安装 工具 ， 也 给 模块 维护 人 员 提 供 了 发 布 工具 。 


大 部 分 开发 人 员 开 始 使 用 npm 是 通过 简单 的 npm install 命令 来 安装 模块 包 。 你 
可 以 安装 自己 本 地 下 载 的 包 ， 但 更 多 时 候 需 要 用 npm 在 注册 库 中 安装 远程 的 包 。 注 
册 库 保存 了 其 他 Node 开发 者 共享 的 包 ， 供 你 使 用 ， 如 数据 库 驱 动 、 流 控制 库 、 数 
学 库 。 你 用 npm 安装 的 大 部 分 库 是 完全 用 JavaScript 编写 的 ， 但 也 有 少数 需要 编译 。 
幸运 的 是 ，npm 会 帮 你 完成 这 些 工 作 。 你 可 以 在 http:Wsearch.npmjs.org 上 查看 注册 
库 中 有 哪些 内 容 。 


8.2.1 搜索 包 
search 命令 会 列 出 在 全 局 npm 注册 库 中 的 所 有 包 ， 并 根据 包 名 进行 过 滤 : 























npm search packagename 
如 果 你 没有 提供 包 的 名 字 ， 那 么 所 有 可 用 的 包 都 会 显示 出 来 。 


如 果 包 列表 过 时 了 (因为 添加 或 删除 了 某 个 包 ， 或 者 你 知道 茶 个 需要 的 包 并 没有 出 
现 )， 可 以 用 以 下 命令 操作 npm 来 清理 缓存 : 








npm cache clean 


下 次 你 问 npm 要 包 列 表 的 时 候 ， 因 为 需要 重建 缓 在， 所 以 该 命令 的 执行 时 间 会 长 


一 些 。 





8.2.2 创建 包 

虽然 你 用 npm 命令 安装 的 大 部 分 包 也 能 为 其 他 使 用 Node 的 用 户 所 用 ,但 编写 一 个 
包 并 不 需要 对 外 公开 。 把 你 自己 的 代码 集中 在 模块 包 里 ， 有 利于 在 不 同 项 目 中 复 用 、 
与 其 他 开发 者 共享 ， 或 者 是 在 演示 或 生产 线 服务 器 上 运行 你 的 程序 。 

包 并 不 限于 模块 或 是 扩展 库 ， 在 许多 情况 下 ， 包 可 以 包含 整个 需要 部 署 的 应 用 。 把 
文件 都 打 成 包 能 使 部 署 更 加 简单 ， 可 以 声明 好 依赖 关系 ， 解 决 从 开发 环境 部 署 到 生 
产 环境 时 通常 需要 猜测 依赖 库 的 难题 。 
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创建 一 个 包 并 不 需要 很 多 额外 的 工作 ， 只 需要 创建 一 个 package.json 文件 ， 并 添加 
关于 你 的 模块 的 简单 说 明 ( 包 的 名 字 和 版 本 号 是 最 重要 的 部 分 )。 要 快速 生成 一 个 有 
效 的 包 文 件 ， 可 以 在 你 的 模块 文件 夹 路 径 下 运行 命令 npm init， 它 会 提示 你 输入 
关于 该 模块 的 描述 信息 ， 然 后 该 命令 会 在 当前 目录 下 生成 一 个 packages.json 文件 。 
如 果 已 经 存在 包 文件 ， 它 的 属性 会 被 作为 默认 值 ， 并 允许 修改 。 


要 使 用 自己 的 包 ， 可 以 使 用 命令 npm install /path/to/yourpacage 进行 安装 。 
路 径 可 以 是 本 地 文件 系统 的 一 个 文件 夹 ， 也 可 以 是 一 个 外 部 URL (比如 GitHub)。 


8.2.3 发 布 包 
如 果 你 的 模块 对 大 众 用 户 也 有 用 ， 并 且 已 经 准备 好 了 ， 那 么 可 以 通过 npm 的 
publish 命令 对 外 发 布 。 发 布 包 内 容 需 要 以 下 操作 。 


(1) 用 aadquser 命令 创建 一 个 用 户 : 

npm adduser 
依照 出 现 的 提示 操作 ， 输 入 用 户 名 、 密 码 和 邮箱 地 址 。 
(2) 用 publish 命令 发 布 包 : 


npm publish 


这 些 就 是 需要 操作 的 所 有 内 容 。 目 前 ， 并 不 需要 注册 或 者 验证 有 效 性 。 











这 体现 了 关于 npm 的 一 个 值得 关注 的 特性 : 因为 所 有 人 都 可 以 发 布 包 ， 而 
一 EE》 上 日 没有 进行 过 滤 或 监督 ， 所 以 你 用 nom 安装 的 包 的 质量 是 没有 保证 的 。 所 
以 说 ， 用 者 自理 ， 









































小 


如 果 之 后 想 要 取消 发 布 自己 的 包 ， 可 以 通过 npm unpublish 命令 实现 。 注 意 ， 
需要 清理 自己 的 包 列 表 缓 存 。 


8.2.4 链接 

虽然 apm 擅长 发 布 和 部 署 ， 但 当初 设计 它 的 目的 主要 是 作为 开发 过 程 中 管理 依赖 项 
的 工具 。npm 1ink 命令 能 创建 你 的 项 目 及 其 依赖 项 之 间 的 符号 链接 ， 因 此 在 项 目 
开发 过 程 中 ， 依 赖 项 中 的 任何 改动 都 能 为 你 所 用 。 


实现 此 效果 之 所 以 必要 ， 有 如 下 两 个 主要 原因 。 


。 你 想 从 当前 项 目 中 通过 require() 访问 另外 一 个 项 目 中 的 功能 。 


si 
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。 你 想 在 多 个 项 目 中 使 用 同一 个 包 ， 而 且 不 需要 在 每 个 项 目 中 都 维护 一 个 版 本 。 

不 加 参数 的 情况 下 调用 npm 1ink 会 为 当前 项 目 在 全 局 包 路 径 中 创建 一 个 符号 链接 ， 
让 你 系统 上 的 其 他 所 有 项 目 都 能 使 用 。 要 使 用 这 个 功能 ， 正 如 前 面 所 说 ， 你 需要 有 
一 个 package.json 文件 。 利 用 npm init 是 生成 这 个 文件 的 初始 版 本 的 最 快 方法 。 











输入 npm link packagename 会 为 该 包 创 建 一 个 从 当前 项 目 工作 目录 到 全 局 模 
块 路 径 中 的 符号 链接 。 比 如 ， 输 入 npm link express 会 在 全 局 包 路 径 中 安装 
Express 框架 ， 并 包含 到 你 的 项 目 中 来 。 每 当 Express 升级 ， 你 的 项 目 会 自动 从 全 局 
包 文 件 夹 中 找到 最 新 版 本 来 使 用 。 如 果 你 在 多 个 项 目 中 链接 了 Express， 所 有 这 些 项 
目 都 会 同步 到 最 新 的 版 本 ， 这 样 就 不 需要 在 Express 升级 时 一 个 一 个 地 操作 了 。 


8.3 ”附加 组 件 


模块 是 指 用 JavaScript 编写 的 Node 扩展 ， 而 附加 组 件 是 指 用 C/C++ 编写 的 扩展 。 
附加 组 件 通常 是 把 现 有 的 系统 库 包 装 起 来 ， 然 后 把 它们 的 功能 暴露 给 Node 使 用 。 
当然 ， 也 可 以 用 它们 来 创建 新 的 功能 ， 但 许多 人 显然 会 选择 使 用 JavaScript 来 做 这 
样 的 事情 。 具 体 来 说 ， 附 加 组 件 是 动态 链接 的 共享 的 对 象 。 


要 创建 一 个 附加 组 件 ， 至 少 需要 两 组 文件 : 组 件 的 代码 和 编译 好 的 文件 。Node 采用 
的 是 Python 的 waf 编译 系统 。 让 我 们 先 从 Hello World 例子 入 手 吧 。 例 8-2 的 功能 
与 在 JavaScript 里 写 上 exports.hello = "world"; 是 等 价 的 。 

例 8-2 一 个 简单 的 Node 附加 组 件 


#include <v8.h> 


























using namespace v8; 


extern "C" void init (Handle<Object> target) { 
HandleScope scope; 
target->Set (String: :New("hello"), String::New("world")),; 


这 段 代 码 做 的 第 一 件 事情 是 把 v8 的 头 文件 包含 进来 ， 因 为 Node 是 构建 在 V8 基础 
上 的 。 它 提供 了 我 们 将 要 用 到 的 许多 标准 对 象 。 下 一 步 ， 我 们 声明 了 命名 空间 ， 然 
后 创建 了 封装 器 ， 所 有 附加 组 件 都 需要 这 样 操作 。 封 装 函 数 就 像 JavaScript 模块 中 
的 全 局 exports 变量 那样 。 我 们 会 将 需要 从 附加 组 件 暴 露出 来 的 内 容 通过 extern 
'C! void init (Handle<Object> target) 这 个 国 数 对 外 公开 。 
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阻塞 操作 


阻塞 操作 在 长 时 间 等 待 资源 的 时 候 ， 要 
求 程 序 和 暂停 下 来 。 


通常 是 请 求 硬件 资源 (如 磁盘 ) 或 网 络 
资源 (如 HTTP 请 求 )。 因 为 请 求 无 法 
马上 从 该 长 时 间 运 行 的 资源 中 获得 结 
果 ， 所 以 即使 这 时 候 系 统 的 CPU 和 内 存 
有 空闲 ， 后 续 的 操作 也 都 会 被 堵塞 ， 直 
到 该 请 求 完成 后 才能 继续 运行 。 





回调 


回调 函数 是 指 当 一 个 塔 塞 操作 完成 之 后 
会 被 “调用 ”的 国 数 ， 通 常 指 的 是 磁盘 
访问 这 类 IO 操作。 回调 函数 可 以 市 参 
数 使 用 。 




















通过 一 组 变量 调用 的 一 段 代 码 集合 ， 可 
以 返回 唯一 的 一 个 值 。 在 JavaScript 中 ， 


词汇 表 


函数 也 有 上 下 文 关 系 ， 因 此 this 变量 
是 保留 值 。JavaScript 中 的 函数 被 认为 
是 第 一 类 (first class)， 因 此 也 可 以 把 
它们 当成 变量 或 对 象 的 属性 。 

对 象 的 功能 单元 。 

非 阻 塞 操作 

非 阻塞 操作 不 会 堵塞 别人 。 
参见 “阻塞 操作 ”。 

伪 类 


伪 类 是 在 JavaScript 中 创建 抽象 对 象 的 
方法 ， 目 的 是 为 了 以 后 初始 化 成 为 对 
象 。 可 以 通过 new 方法 把 伪 类 转变 成 对 
象 。 为 了 与 其 他 类 型 对 象 区 别 开 ， 伪 类 
的 首 字母 采用 大 写 形式 。 比 如 ，server 
是 一 个 伪 类 ， 而 server 则 可 能 是 它 的 
一 个 实例 。 
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关于 封面 





本 书 封面 上 的 动物 是 普通 树 购 (Tupaia glis) ， 树 栖 哺乳 动物 ， 出 没 在 东南 亚 的 南部 
地 区 ， 通 常生 活 在 森林 中 ， 偶 尔 也 会 出 现在 果园 和 花园 里 。 它 们 善于 攀 爬 ， 并 能 跳 
跃 跨 过 两 英尺 远 的 树木 。 它 们 白天 活动 ， 以 植物 、 种 子 、 水 果 、 蚂 蚁 、 蜂 蛛 和 小 蜥 
蝎 为 食 。 

普通 树 网 身长 6~8 英寸 ， 毛 草 朝 的 尾巴 和 身子 一 样 长 ， 嘴 尖 细 ， 爪 有 五 趾 ， 皮 毛 呈 
黑色 、 灰 色 或 谈 红 色 ， 肚 皮 呈 白色 。 “ 树 购 ”这 个 属 名 源 于 马 来 语 的 “松鼠 "， 因 为 
两 者 有 些 相 似 。 人 们 曾经 认为 树 移 与 灵 长 类 动物 沾 亲 带 故 ， 但 现在 它们 有 了 自己 的 
目 一 一 树 移 目 。 

普通 树 网 在 几 个 月 大 的 时 候 就 会 性 成 熟 ， 然 后 进行 交配 。 雄 性 树 鞠 会 筑 造 两 个 梨 父 ， 
一 个 给 自己 与 配偶 ， 一 个 给 幼 仔 。 但 是 父母 对 幼 仔 关爱 不 足 ， 雌 性 树 网 两 天 才 去 看 
望 幼 仔 一 次 ， 仅 哺育 它们 几 分 钟 。 


封面 图 片 出 自 Lydekker 所 著 的 Natural History 一 书 。 
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Node Web 开 发 


Professional JavaSeript for Web Developers yu sso 





Web Programming 





Node 即 学 即 用 


Node 正 迅速 成 为 Web 开 发 社区 里 最 有 影响 力 的 技术 之 一 。 你 一 定 想 “本 书 探讨 了 Node 及 许多 第 
快速 掌握 Node， 学 习 如 何 用 JavaScript 开 发 服务 器 程序 。 有 了 这 本 ”三方 模块 ， 并 给 出 了 指导 练 


指南 ， 


你 就 能 学 会 用 Node 构 建 高 度 可 扩展 的 服务 器 程序 ， 理 解 它 的 。 习 ， 旨 在 带 你 了 解 Node。 通 


事件 循环 架构 如 何 降低 开发 的 复杂 度 并 且 保 证 服务 器 编程 的 安全 与 。 过 学 习 本 书 ， 你 不 但 能 够 熟悉 


便捷 。 


本 书 是 Node 开 源 框架 主要 贡献 者 的 最 新 力作 ， 解 析 了 为 什么 Node 
的 单线 程 方法 能 够 在 多 台 服 务 器 间 支 撑 起 大 量 的 并 发 连接 ， 并 让 我 
们 看 到 了 在 浏览 器 与 服务 器 间 共 享 代码 是 何等 便利 。Node 何 以 能 俘 
获 Google、LinkedIn 及 eBay 等 众多 大 牌 公司 的 芳心 ? 本 书 将 向 你 解 


JavaScript 的 基本 操作 ， 还 能 
逐渐 开始 构建 复杂 、 交 互 式 的 
网 站 。 如 果 你 曾经 使 用 过 其 他 
服务 器 端 Web 框 架 ， 定 会 震惊 
于 用 Node 这 么 容易 就 能 编写 一 


个 Be| ” 
释 其 原委 。 一 
通过 阅读 本 书 ， 你 可 以 : Node 之 父 
日 学 习 Node 的 事件 循环 架构 、 非 阻塞 /O 和 事件 驱动 编程 模 “本 书 很 好 地 诠释 了 Node 的 精 
型 ， 做 ， 并 讲述 了 如 何 用 它 构建 交 
四 动手 编写 /O 示 例 应 用 ， 其 中 包括 一 个 聊天 服务 器 ， 互 式 网 络 应 用 和 网 站 。Node 
a 用 现成 的 设计 模式 编写 事件 驱动 程序 ; er ne 
日 在 多 核 环境 下 高 效 地 运用 Node 的 单线 程 策略 ; 享受 阅读 的 乐趣 吧 ! ” 
四 配合 具体 例子 ， 深 入 框架 核心 及 API 工 具 ， 一 一 Brendan Eich, 
目 学 习 Node 如 何 支持 多 种 数据 库 和 存储 工具 ， JavaScript 之 父 
虽 利用 Node 庞 大 的 模块 库 构 建新 的 扩展 。 
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最 前 沿 的 上 T 类 电子 书 发 售 平台 

































































































































































电子 出 版 的 时 代 已 经 来 临 。 在 许多 出 版 界 同行 还 在 犹 图 灵 社 区 进一步 把 传统 出 版 流程 与 电子 书 出 版 业务 
鸳 簿 特 的 时 候 ， 图 灵 社 区 已 经 采取 实际 行动 拥抱 这 个 放电 合 ， 目 前 已 吉 化 主 才 网 上 二 和 : 枯 同 同 上 
出 版 业 巨 变 。 作 为 国内 第 一 家 发 售 电子 图 书 的 IT 类 出 审 稿 、 按 章 发 布 的 电子 出 版 模式 。 这 种 新 的 出 版 模 
版 商 ， 图 灵 社 区 目前 为 读者 提供 两 种 DRM-free 的 阅读 式 ， 我 们 称 之 为 “敏捷 出 版 ”， 它 可 以 让 读者 以 较 
体验 : 在 线 阅读 和 PDF。 快 的 速度 了 解 到 国外 最 新 技术 图 书 的 内 容 ， 弥 补 以 

往 翻 译 版 技术 书 “ 出 版 即 过 时 ”的 缺憾 。 同 时 ， 敏 
































旧 比 纸 质 书 ， 电 子 书 具有 许多 明显 的 优势 。 它 不 仅 发 
布 快 ， 更 新 容易 ， 而 且 尽 可 能 采用 了 彩色 图 片 (即使 
的 书 纸 质 版 是 黑白 印刷 的 ) 。 读 者 还 可 以 方便 地 进 
行 搜索 、 剪 贴 、 复 制 和 打印 。 





捷 出 版 使 得 作 、 译 、 编 、 读 的 交流 更 为 方便 ， 可 以 
提前 消灭 书稿 中 的 错误 ， 最 大 程度 地 保证 图 书 出 版 


的 质 1 - 
































































































































最 方便 的 开放 出 版 平台 直接 的 读者 交流 平台 


图 灵 社 区 向 读者 开放 在 线 写 作 功 能 ， 























协助 你 实现 目 出 在 图 灵 社区 ， 你 可 以 十 分 方便 地 写作 文章 、 提 交 勘 































































































版 和 开源 出 版 的 梦想 。 利 用 “合集 ”功能 ， 你 就 能 联 误 、 发 表 评 论 ， 以 各 种 方式 与 作 译 者 、 编 辑 人 员 和 
合 二 三 好 友 共 8 同 创作 一 部 技术 参考 书 ， 以 免费 或 收费 其 他 读者 进行 交流 互动 。 提 交 勘 误 还 能 够 获 赠 社区 
的 形式 提供 给 读者 。 (收费 形式 须 经 过 图 灵 社 区 立项 银子 。 

评审 。) 这 极 大 地 降低 了 出 版 的 门槛 。 只 要 你 有 写作 

的 意愿 ， 图 灵 社 区 就 能 帮助 你 实现 这 个 梦想 。 成 熟 的 你 可 以 积极 参与 社区 经 常 开展 的 访谈 、 审 读 、 评 选 
书稿 ， 有 机 会 入 选 出 版 计划 ， 同 时 出 版 纸 质 书 。 等 多 种 活动 ， 廊 取 积 分 和 银子 ， 积 里 个 人 声望 
































图 灵 社 区 引进 出 版 的 外 文 图 书 ， 都 将 在 立项 后 马上 在 
社区 公布 。 如 果 你 有 意 翻 译 哪 本 图 书 ， 欢 迎 你 来 社区 
请。 只 要 你 通过 试 译 的 考验 ， 即 可 签约 成 为 图 灵 的 
译 者 。 当 然 ， 要 想 成 功 地 完成 一 本 书 的 翻译 工作 ， 是 

需要 有 坚强 的 尹 力 的 。 RE 


















































































































































